--- name: orshot-template-design-from-brief description: Turn a plain-language brief into a reusable Orshot template, collecting size, format, fields and brand assets first, then creating the folder and template, duplicating it into variants and checking each one before it is used. Use when the user describes a design they want to make reusable (a social graphic, carousel, certificate, product card, invoice or PDF) and asks to create, build, make or set up a template in Orshot. --- # Design a reusable template from a brief The aim is a template that can be rendered again and again with different data, not a one-off picture. Every field you leave as fixed text is a field someone will later have to fix by hand. Decide the variable parts before anything is created. ## 1. Pin down the brief before touching the workspace Read the request and write back, in one short list, what you will build: - **Format and size.** Social square (1080x1080), portrait post (1080x1350), story or reel cover (1080x1920), landscape document or certificate, A4 or letter PDF. If the user names a platform, use its standard size and say which one you picked. - **Output type.** Image, multi-page carousel, PDF or video. A carousel is several pages of one template, not several templates. - **Variable fields.** Anything that changes per output: headline, body, name, price, date, photo, logo, ID number. Use a short field name for each (`headline`, `product_photo`, `price`). - **Fixed elements.** Background, brand colors, footer, logo that never changes. - **Variants needed now.** A list of the sizes or colour themes the user wants on day one. Often the answer is "one master, resized later", which is a cheaper plan. If size, output type or the list of variable fields is missing and cannot be inferred, ask one focused question. Do not guess a layout the user will then reject. ## 2. Check the brand kit before designing Brand assets are the difference between an on-brand template and a generic one. Before creating anything, look at what already exists: - Brand colours and fonts the user has already set up. - Logos and reusable images. Use the library reads that the connector offers (for example the brand-asset and template listing tools) rather than assuming. If the user's brand colour is not in the kit yet, you may propose adding it with `orshot_add_brand_color`, but that is a write: wait for the user's explicit yes first. Pick a font and a colour scheme from the kit. Do not invent a palette the user did not give you; if they gave none, propose two options and let them choose. ## 3. Find or create the folder Keep one folder per campaign or client, so templates are findable and so cleanup later is possible. Look for an existing matching folder first. Create one only if none fits, using `orshot_create_template_folder`. This creates state: wait for the user's explicit yes before creating it, and state the folder name you intend to use. ## 4. Create the master template Build the master with `orshot_create_template_design`, passing the size, the layers and the variable field names from step 1. Name it for its purpose and format (`launch-carousel-cover-1080x1350`), not `Untitled`. Creating a template is a write: wait for the user's explicit yes, and show the planned name, size and field list in that request. Give every variable field a clear default so a test render is readable. Lorem-style placeholder text hides overflow bugs; use realistic text lengths, including one long one. ## 5. Duplicate into variants, do not rebuild When the user needs another size or colour theme, use `orshot_duplicate_template` on the master and change only what differs. Rebuilding from scratch means the variants drift apart. Each duplicate is a write: list the intended copies and wait for the user's explicit yes before creating them. Remove a duplicate the user rejects with `orshot_delete_template` only after a separate explicit yes; never delete as part of building. ## 6. Check every template before handing it over A template is not finished until it has been checked against real content: 1. **Longest-text test.** The longest realistic headline and the longest name must fit without overlapping or cropping. If not, widen the box, reduce size or allow wrapping. 2. **Empty-field test.** What does the layout look like when an optional field is blank? A missing logo or subtitle should not leave a hole or a broken line. 3. **Image-ratio test.** A photo of the wrong shape must still look intentional: cropped to a fixed frame, not stretched. 4. **Brand test.** Colours and fonts match the kit, and the logo is in the same place on every variant. Report the result of each test in the output. If a test fails, fix the master and re-duplicate; do not patch only one variant. ## Common patterns and traps - **Designing for the sample text, not the data.** The layout looks perfect with "Hello world" and breaks at 90 characters. Always test the longest realistic value. - **Hard-coded values that should be fields.** A price or date typed into the design means every new product means a new template. If it changes per output, it is a field. - **One template per variant, built separately.** Colour and spacing drift within a week. Duplicate the master instead. - **Template named "Untitled" or "Copy of Copy".** Nobody can find it later and cleanup becomes guesswork. Name by purpose, format and date. - **Carousel built as five templates.** Use one template with several pages where the pages share a design, so the fields stay consistent. - **Forgetting the PDF page size.** A certificate built on a screen size prints wrong. Choose the PDF page size up front. - **Assuming a font exists.** If the brand font is not in the kit, the output will fall back to a default. Check the kit first. ## Output ``` Brief: Variable fields: (), ... Fixed elements: Folder: (created: yes/no) Master: