Docs
Start building
AI Engine

Site Specification

The validated document every website, design, deck, document and dashboard is built from.

What is in it

FieldHolds
versionThe schema version the specification was written against.
businessThe business: its name, tagline, industry and contact details.
languageThe page language, such as en or ar. Right-to-left languages are laid out right to left.
themeA design preset, the brand colour, the typeface, the corner radius, the amount of motion and the spacing density.
pagesOne to 12 pages, each with a path and up to 20 sections.
seoThe description and keywords for search engines.

Sections

A page is a list of sections, each one of a fixed set of types — hero, features, pricing, FAQ, gallery, charts, slides, poster and more — with its own fields. The full list is on the Websites page.

A small example

site-spec.json (abridged)
{
  "version": 1,
  "business": { "name": "Fade & Co", "industry": "barber", "tagline": "Sharp cuts, no waiting" },
  "language": "en",
  "theme": { "preset": "…", "primaryColor": "#b08d57", "font": "satoshi", "radius": "md" },
  "pages": [
    { "path": "/", "sections": [
      { "type": "hero", "title": "Sharp cuts, no waiting", "cta": { "label": "Book now", "href": "#contact" } },
      { "type": "pricing", "…": "…" },
      { "type": "contact", "…": "…" }
    ] }
  ],
  "seo": { "description": "Barber shop in Leeds…" }
}

Where you meet it

  • A GitHub export includes it as site-spec.json beside the HTML.
  • The MCP tools get_project and validate_spec return and check it — see Available Tools.