Write it as a blueprint
A site can be authored as one Markdown file — front matter for the site, theme and nav, then one section per tile. Compile it to content.json, then build the pages.
Front matter
---
site:
name: My site
baseUrl: https://example.com
theme:
colors: { background: "#F7F8FA", primary: "#1B3A5C", accent: "#2F6FED" }
dark: { background: "#0B0F17", text: "#E7ECF3" }
nav:
- Home: /
- Services: /services.html
integrations:
forms: formspree
---One section per tile
path: /
description: Opening band.
id: home-hero
headline: Your headline
body: |
A sentence that explains what this is.
actions:
- label: Get started
href: /contact
style: goldThe pipeline
Gather
Fill the intake form — business, brand, sitemap, per-tile copy, integrations.
Author
Write the blueprint. Humans and AI agents both produce this format, so either can pick up the other's work.
Compile
tools/blueprint.mjs emits content.json and warns about unknown tiles or unregistered fields.
Compose
Paste the tile markup into a page. Structure and CSS are fixed; the words come from the file.
One command
The compiler is build-time only — the delivered site stays dependency-free. It validates tile types and field names against the tile registry, so a typo becomes a warning rather than a broken page.
Questions
Is the blueprint required?
No. It is a convenience for authoring and for AI collaboration. You can edit content.json directly, or edit the copy in the admin.
Can an AI write the blueprint?
Yes — that is the intended division of labour. The AI drafts the blueprint, the compiler produces the site, the owner maintains the copy in the admin.