Operazioni sul brand

Set the site's brand from three colours, a type pairing, a type ratio and base size, a spacing unit and a corner style: the server derives every token write of the brand (the brand, accent and neutral palette ramps, the light and dark colour roles as aliases of palette steps, the font sizes and families, the main type presets, the space steps and the radii) and lands them as one designSystem.setTokens change, gated once for AA contrast on the end state, so one undo restores the lot. A brand with pairs below AA is refused unless the input carries acknowledgeContrast: true, the designer's explicit "save anyway", which the stored batch keeps; then the failing pairs come back as error findings. The admin's Brand setup screen runs this same operation.

I campi più annidati sono nello schema di output che risponde discover_operations con outputSchemas: true.

List the site's brand presets, the brand identities its brand templates draw from, each with its id, name and last change. Brand validation applies, and history.undo restores the brand rows the batch changed.

L’input è un record: vedi lo schema qui sotto.

List the site's brand templates, the fixed-size canvases (a social post, a banner) brand.render draws: each with its name, size, status (draft or approved), version and canvas page. Brand validation applies, and history.undo restores the brand rows the batch changed.

L’input è un record: vedi lo schema qui sotto.

Patch a brand identity (the default preset's, or presetId's): its brand name, tagline, logos, the four brand colours, the headline and body roles, the tone words and the do and don't rules. Brand validation applies, and history.undo restores the brand rows the batch changed.

Add a brand preset named presetName: a copy of preset cloneFrom, or without it the theme's default identity for the site. Brand validation applies, and history.undo restores the brand rows the batch changed.

Rename a brand preset. Brand validation applies, and history.undo restores the brand rows the batch changed.

Delete a brand preset; the site's last one is refused (409 brand_last_preset). Brand validation applies, and history.undo restores the brand rows the batch changed.

Vuole confirmed: ["destructive"] sul batch, che la forma della CLI per una sola operazione non imposta: mettila in un file di batch ed esegui yarn splash apply <file> --dry-run.

Create a brand template: a canvas page of width by height pixels (fixed at creation) with a first section, laid out from one of the theme's canvas presets when layoutId names one. Edit its content with tree.commit on its page, then approve it with brand.updateTemplate. Brand validation applies, and history.undo restores the brand rows the batch changed.

Rename a brand template, approve it (status: "approved" with expectedDraftRevision, the canvas revision you approve: that canvas becomes the version brand.render draws) or set which of its fields a person may change when generating (customerSettings). Brand validation applies, and history.undo restores the brand rows the batch changed.

Delete a brand template, then its canvas page. Brand validation applies, and history.undo restores the brand rows the batch changed.

Vuole confirmed: ["destructive"] sul batch, che la forma della CLI per una sola operazione non imposta: mettila in un file di batch ed esegui yarn splash apply <file> --dry-run.

Recreate the canvas page of a brand template whose page was deleted, from its last approved snapshot (refused when it has none); edits made after that approval do not come back. Brand validation applies, and history.undo restores the brand rows the batch changed.

Render an approved brand template to a PNG (scale 1 or 2) in a brand preset (presetId), with the overrides of the fields its curation lets a person change (overrides, by node), and answer it as base64 without storing it. The render runs in a standalone boundary; run it alone in a batch.

Un dry run rifiuta un’operazione esterna, quindi non ha una riga di prova: eseguila da sola in un batch.

Render an approved brand template as brand.render does and store the PNG in the media library, with the record of how it was made. The render runs in a standalone boundary; run it alone in a batch.

I campi più annidati sono nello schema di output che risponde discover_operations con outputSchemas: true.

Un dry run rifiuta un’operazione esterna, quindi non ha una riga di prova: eseguila da sola in un batch.