formats

# formats The single source of truth for canvas formats. Each format has its own file — read the file(s) for the format(s) you're targeting: `<id>.md`. The table below already answers size, aspect, medium and safe zones / print for every format. ## Pick a format | id | size | aspect | medium | safe zones / print | file | | ------------------- | -------------------------------- | ------- | ------ | ------------------------------------------ | ---------------------- | | `ig-post` | 1080 × 1350 px | 4:5 | screen | profile grid crops 34 px left · right | `ig-post.md` | | `ig-square` | 1080 × 1080 px | 1:1 | screen | none (no chrome) | `ig-square.md` | | `ig-story` | 1080 × 1920 px | 9:16 | screen | **top 269 · bottom 672 · sides 65 px** | `ig-story.md` | | `tiktok` | 1080 × 1920 px | 9:16 | screen | **top 240 · bottom 660 · sides 120 px** | `tiktok.md` | | `yt-shorts` | 1080 × 1920 px | 9:16 | screen | **top 288 · bottom 672 · right 192 px** | `yt-shorts.md` | | `widescreen` | 1920 × 1080 px | 16:9 | screen | none (no chrome) | `widescreen.md` | | `linkedin-post` | 1200 × 627 px | ≈1.91:1 | screen | none; feed may crop edges | `linkedin-post.md` | | `x-post` | 1600 × 900 px | 16:9 | screen | none; timeline may crop edges | `x-post.md` | | `youtube-thumbnail` | 1280 × 720 px | 16:9 | screen | bottom-right duration badge | `youtube-thumbnail.md` | | `deck` | 1920 × 1080 px per slide | 16:9 | screen | none | `deck.md` | | `poster` | A2 420 × 594 mm / 1080 × 1920 px | — | both | print: 3 mm bleed · ≥300 dpi | `poster.md` | | `flyer` | A5 · A4 · DL | — | print | 3 mm bleed · ≥300 dpi | `flyer.md` | | `business-card` | EU 85 × 55 mm · US 3.5 × 2 in | — | print | 3 mm bleed · ≥300 dpi | `business-card.md` | **Custom sizes:** an explicit `W×H` (+ unit: px, mm, in) is always valid, and is the page size on both media; print medium sets **3 mm bleed** on that page (Print basics) and targets **≥300 dpi**. ## Shared rules - **Safe zones (screen):** platform chrome overlays the canvas edges on some placements — keep primary content inside the safe band. Per-format numbers live in each format's file; content-only formats (square, widescreen) have no chrome and use the full frame inside the margins. - **Print basics:** the page is the **trim size** (A5 is 148 × 210 mm), never trim plus bleed. Bleed is the page's own setting and lies outside the page: `await engine.design.setProps(page, { page: { marginEnabled: true, margin: { top: '3mm', right: '3mm', bottom: '3mm', left: '3mm' } } })` — **3 mm** unless the printer states another. A background or image that touches an edge runs to the bleed's outer edge (a full background: position `'-3mm'`, 6 mm wider and taller). Text stays inside the **~8% safe margin**, or the margin the printer states, measured from the page edge (handbook §6.1.10, §6.4). Target **≥300 dpi**; fonts embedded/outlined. CMYK and spot colours, safety inset and the PDF/X export: `../handbook/print.md`. - **Composition is relative to the canvas** — margins, spacing, and type bands all scale with the page (handbook §6.4, §6.1.2), so the design rules hold across every format here. - **Export at native dimensions** — the page's own size. A page with bleed carries it into every file: a `pdf` or `pdfx` page is trim plus bleed with the trim marked (TrimBox), and an image or a `preview` shows the bleed around the page. With `marginEnabled: false` the same files are the trim size. ## Boundaries - **Re-composing an existing design into another format** — the `resize` skill (workflow, re-composition routine, no-goes). This skill only supplies the target's numbers. - **Choosing a format during new-design intake** — the `create` skill derives it from the brief; its class defaults mirror this skill's files.