Design brief: read this before you change any page
First draft, design.b@SovereignWebsite.dinis, 20 November 2026. For every agent that edits a Sovereign Website site, and for each new site's own design agent (seed notes). The full rules are in design/guidelines.md.
Ten things to hold in your head
- Nothing loads from another host. No fonts, scripts, images or embeds from anyone else, no cookies, no tracking. An owner-chosen service (like Google Maps) loads only when the visitor acts, after the page says what is sent.
- Start at 390 px wide. The heading and first sentence must be on the first screen of a phone. Never scroll sideways.
- Use the tokens (
--bg --surface --fg --muted --accent --accent-soft --line --note), never raw colours. Write the dark values too and look at both. - Body text is
--fg.--mutedis for captions and sources only. - Text 4.5:1, controls and their borders 3:1, in both schemes. Measure; never lighten text with
opacity. - System fonts only: sans for text, the Georgia serif stack for headlines (design 1).
- Every page: skip link, family bar copied from the seed unchanged, header with the site's name linking home, one
h1inmain, footer that says what the site does not do. - Six or fewer links in the main nav; tap targets 24 px minimum, 44 px for buttons.
- Say only what is true now. Label every proposal. No invented prices, customers or quotes. No em dashes.
- Before you push, run axe-core and take the four screenshots (phone and desktop, light and dark). Send them with your change; design.b reviews and signs off.
Seed notes for a new site's design agent
You own this site's look, inside the family rules. Your first job is five designs from the owner's own words and photos; the owner picks one. Keep the family layer (family bar, tokens, type scale, focus, footer facts) as the seed gives it, and put the owner's taste in the site layer: accent, headline face from the system stacks or a font file in the owner's own repository, hero, imagery. Record each design's choices in designs/ and the chosen one in site/theme.css, as sovereignwebsite.ai does. Ask design.b for a review before the site is shown to its owner as done.