moda-deck-theme
<!-- moda:banner -->
PREREQUISITE — load once per session (step-0, write contract,
free/metered map). Already loaded? Skip ahead. If you cannot load it, the
non-negotiables: run
before anything;
before creating; every write carries the latest revision — on
, re-read and retry once (it heals); send the canvas link the
moment it exists; stuck or failed?
— free and fast,
never guess.
<!-- /moda:banner -->
What this is
A wizard-style flow for establishing a deck's visual theme with the user before any real content exists. Runs on a blank 1920×1080 slides canvas with a brand kit applied, and ends with twelve placeholder slides that define a complete visual system. If the canvas already has designed slides, or the user wants specific content designed right now, say so and ask how they want to proceed.
Five phases, each gated on explicit approval. Do not generate the next phase without it — "what's next?" or "let's move on" is the gate. Anything the user said in their opening prompt supersedes the defaults below; acknowledge it so they know you read it.
Set up, then open by setting expectations in a sentence or two — four title directions, then section heads and a closing, then the workhorse layouts, pausing at each step, all content placeholder — and go straight into Phase 1:
- , then
moda canvas create --name "[Deck] theme" --intent "a slide theme: 4 title directions, ceremonial slides, 8 workhorse layouts" --size 1920x1080 --pages 1 --category slides --brand [KIT]
moda canvas share CANVAS_REF
- LOOK at the kit's assets before designing anything (references/brand.md), and compute the type ladder from references/design-quality.md (1920×1080 → body ≈ 40px, floor 18px).
Phase 1 — Title slide, 4 variants
moda canvas add-pages CANVAS_REF --count 3
, then one
moda canvas markup CANVAS_REF --file - --page P
per variant: four title slides, each a genuinely different aesthetic axis, all using the brand kit's real colors, type and logo (the variants explore
design language, not brand attributes). Pick four from: type-led/anthemic · image-led · editorial · compositional/off-grid · minimalist/reductive · color-shock/block · maximalist/layered · geometric/constructivist · tactile/hand-made · technical/diagrammatic. With directional hints from the user, pick four that fit the direction; without hints, span clearly different territory — one type-driven, one image-driven, one color/composition-driven, one wildcard — and vary your picks across sessions.
Name each page with a letter and its approach ("A — Anthemic") so the user can reference them; page names are set in the edit lane (
update(pageId, { name: 'A — Anthemic' })
, references/edit-code.md).
moda canvas screenshot CANVAS_REF
and LOOK before presenting. Present them as a choice, noting that only one moves forward and the other three get deleted, so this is the moment to choose.
- Picks one → make any requested edits, then delete the other three (
moda canvas delete-items CANVAS_REF [PAGE_IDS]
- Wants a hybrid ("type from A, layout from C") → build a fifth variant, delete the rest.
- None work → ask one question — which axis was wrong (typography, layout, color, imagery)? — then generate a fresh four from the remaining approaches. Never iterate on rejected variants.
Unsure which axes a second round should use?
moda ask "which aesthetic axes should the second round of slide title variants use after the first four were rejected?"
.
Phase 2 — Ceremonial slides
moda canvas add-pages CANVAS_REF --count 3
— three slides that set the deck's emotional register, all visibly siblings of the title (same type pairings, color logic, grid):
- Section head, punchy — a moment. Large type, strong color, for major breaks.
- Section head, quiet — restrained, more whitespace, for subsections. The pair is what gives the deck rhythm instead of every break landing the same.
- Closing / thank you — mirrors the title's energy with a sense of arrival, often the title's composition with one clear shift (inverted color, mirrored alignment).
Screenshot all three, present them together, and iterate until approved.
Phase 3 — Theme contract
Write the locked system out in plain prose to the user (not a slide, no approval needed — it's a status update): type scale (which font for display vs body, exact sizes, caps/weight rules), color roles (which brand color is background, accent, type, data emphasis), layout pattern (grid, alignment, margins, whether off-grid is in play), image treatment, and logo behavior. Close with: every workhorse slide will adhere to this — now's the moment to adjust. Without this contract Phase 4 drifts; it's the connective tissue and the thing specific feedback points back to.
Phase 4 — Workhorse slides
Eight layouts, generated
2–3 at a time with a feedback pause between batches so drift gets caught before it compounds: big number / stat hero · two-column comparison · quote / testimonial · 3-up grid · full-bleed image with caption · text-content slide · timeline / process flow · data slide. One
apply per slide,
after each batch, and LOOK. Every one must visibly inherit the theme contract; if a slide could belong to a different deck, redo it before moving on.
The text-content slide especially: do not default to bullet lists. Carry the 3–5 points with typographic hierarchy, color emphasis, or a numbered sequence.
Phase 5 — Handoff
Summarize the twelve slides — title, two section-head styles, closing, eight workhorse layouts — point back to the live link, and offer the two natural next moves: apply the theme to real content, or refine a specific slide. Export only on the user's format words or one accepted offer:
moda export CANVAS_REF --format pptx|pdf -o …
.
Throughout
- Placeholder content only. Never invent specific facts, real-sounding metrics, named people or company claims. "Section title here", "Key insight", "47%", "Discover / Build / Launch". Real-looking content invites the user to mistake it for a real claim.
- One or two sentences of design rationale per phase ("all-caps because your display font has strong caps"). Enough to make feedback precise, not an explanation of the design.
- Vague feedback gets exactly one question — which axis — then proceed.
- Iterate refines the direction; pivot abandons it. On a pivot, don't anchor to the previous attempt.
- A targeted fix to an approved slide is a small code batch (references/edit-code.md); a whole-slide rebuild is
moda canvas markup --mode replace
Errors
names the element it skipped — one page per apply, then re-run.
heals: re-read and retry once. Anything else → load moda-core and read its recovery reference.
See also: moda-deck — the full deck build once a theme exists ·
moda-core — the contract, recovery, everything Moda can do.
References
| Doc | Load when |
|---|
| references/deck-design.md | before Phase 1 — concept-first covers, the layout bar |
| references/markup.md | before any markup apply |
| references/design-quality.md | the type ladder, imagery, shaders, the AI-slop list |
| references/brand.md | a kit is bound — look at its assets, not just its tokens |
| references/edit-code.md | page names; targeted edits to an approved slide |