Sovereign Website design guidelines

First draft, design.b@SovereignWebsite.dinis, 20 November 2026 (10:33 UTC). Not yet agreed by Dinis Cruz. Every rule here is a proposal until he says yes. "Must" is a sign-off condition; "should" is a strong default that a site's design agent may break with a written reason.

Starting point: design 1 of sovereignwebsite.ai, "the plain promise", chosen by Dinis on 20 November 2026 (SovereignWebsite__Website site/theme.css). The other sites are measured against these rules in design/reviews/.

1. What a site must never do

These are absolute. A site that breaks one is not signed off.

  1. No cookies, no tracking, no analytics, no fingerprinting, no third-party pixels.
  2. No request to another host on page load: no web fonts, scripts, styles, images, iframes or embeds from anyone else.
  3. A third-party service is allowed only when the owner chooses it, and then only on a visitor's action, with the page saying beforehand what is sent and to whom. Site__google-maps is the reference: nothing goes to Google until the button is pressed, and the page says so next to the button. Such a site must carry a Content Security Policy that names only those hosts.
  4. No server code, no database, no forms that post to us. Static files only.
  5. No dark patterns: no pre-ticked boxes, no countdowns, no fake scarcity, no hidden cost, no confirm-shaming.
  6. No invented facts, prices, customers, testimonials, logos or numbers. A proposal is labelled as one where it is shown (the .ai "Proposal only" tag is the pattern).
  7. No private person named without their consent. Made-up examples are labelled made-up.
  8. No horizontal page scroll at any width from 320 px.
  9. No text in images; no image without alt (empty alt="" for decoration).
  10. No em dashes or en dashes in text.
  11. Browser storage only for what the visitor asked to keep, and the page says so (the Vault's "kept here, in this browser's own storage, until you forget them" is the pattern).
  12. On a customer's site, the page is about the owner, not about us (Dinis Cruz, 20 November 2026: "This website is for them... not a website about us"; and on the first fix: "better Too much. It needs to fundamentally be about the site and who is it about. I'm happy that just shows on some top right pop-up menu."). Our links (the Sovereign Website family) appear only in one small pop-up menu at the far top right, after the owner's own navigation and "Choose a design": a button that opens a list, closed by default. No family bar, strip or row of our links anywhere on the page; a small footer credit is optional and the owner may remove it. Any review that finds our links outside that menu fails. Our own organisation sites keep the family bar.
  13. Every customer site has three pages, and each is easy to find (Dinis Cruz, 20 November 2026: "those links need to be very visible"):
    • /start/: where to start, for the owner, including connecting GitHub and their own Claude;
    • /agents/ and /llms.txt: how to use this site with an AI, as on yiheng-wang.agenticcells.site;
    • /admin/: how the site was made: its agents, design rounds, commits and synthetic-user runs (it can link to or pull rounds/<site>.json on design.agents.sovereignweb.site). They are linked in the header's right-hand area or directly under the hero, and again in the footer; on a phone, in the menu. A review fails if one is missing, answers anything but 200, or is hidden.
  14. Every page has a link preview (Dinis Cruz, 20 November 2026: "we are missing the social media link preview image"): og:title, og:description, og:type, og:url, og:image (absolute URL), og:image:alt, og:image:width and og:image:height, plus twitter:card (summary_large_image), twitter:title, twitter:description and twitter:image. The share image is 1200 x 630, made from the owner's own cleared material, served from the site itself. design.b's audit fetches it and fails the review unless it answers 200 at 1200 x 630.

2. The family and the site

Every site is two layers:

The SovereignWebsite organisation's own sites (.ai, .org, .site, hub, vault, demos) should share one identity, taken from design 1: warm paper background, terracotta accent, serif headlines, system sans body. Proposal, for Dinis: either all own sites move to design 1's palette, or .ai keeps terracotta and the infrastructure sites take a named sibling palette from the same family. Today they are two unrelated looks (see review).

2a. Five designs, always

Every site has five designs (Dinis Cruz, 20 November 2026: "a key requirement is 5 designs"). They show what the team can do and let the owner choose. They live in site/designs/1.html to 5.html with an index, one tap apart, as on sovereignwebsite.ai; the chosen one becomes site/theme.css. The five must differ in idea, not only in colour, and each idea comes from the owner's own world, as on the AgentiCCells personal sites (examples page): a filmmaker's Premiere, a composer's Cue Sheet and Record Sleeve, a pastry chef turned project manager's Pass, with her results as order tickets on a rail. Each design is named for its idea and rebuilds the page around it: the structure, the hero, the order of sections and the way facts are drawn change, not just colours and fonts. Five skins of one layout do not count as five designs. At least one should be designed dark first, and one should be the plain, printable version (a Brief) for people in a hurry.

Concept first, then craft: before any CSS, write for each design one sentence saying what it is a metaphor for, and which of the owner's own facts it will draw (a timeline, a cast list, a map, a set of tickets). Nothing drawn may be invented. Each of the five meets every rule in this document, light and dark, before it is shown. A site without five designs is rated no higher than 2 (rating.md, level 3 needs them).

3. Layout

4. Type

5. Colour and dark mode

6. Spacing

7. Components

Shared names, so every agent builds the same thing the same way. Reference implementations are in SovereignWebsite__Website site/style.css and theme.css.

Component Rule
Family bar Same markup and CSS on every site, from seed/shared/. aria-current="true" on the current site. Links reach 24 px tall.
Header Brand (mark and name) linking home, primary nav (six or fewer), language switch when there is more than one language.
Button Solid accent for the one main action, outlined for the second. At least 44 x 44 px on touch screens. One main button per screen.
Link Underlined in text. Navigation links may drop the underline but must show it on hover and focus.
Card --surface, 1px --line, radius .6rem. A whole-card link has one link, on the heading.
Ticket (offer) Design 1 dashed accent border. Only for an offer, and always with its label (Proposal only, Published anchor).
Note --note background, 4px accent left border. For warnings and statements of what is not true yet.
Steps, levels, promises Numbered lists (ol), the number from a CSS counter, never typed into the text.
Form field Visible label above, 3:1 border, 16 px text minimum (prevents phone zoom), placeholder only as an example, never as the label.
Code Monospace system stack, wraps or scrolls inside its own focusable box.
Footer What the site does not do (no cookies, no tracking), its source, its licence, and where things stand.

8. Accessibility (WCAG 2.2 AA)

Sign-off needs all of these, checked by axe-core and by hand:

9. Performance

10. Writing voice

11. Sign-off

A site version is done for a customer only when design.b has recorded, in design/reviews/<site>/<date>.md:

  1. The commit reviewed and the live address.
  2. Screenshots at 390 and 1366 px, light and dark, of every page.
  3. The automated results: axe-core, third-party requests (must be none, or only the owner's chosen service after an action), cookies (none), storage, horizontal overflow, page weight.
  4. The hand checks: keyboard path, focus, zoom to 200 per cent, reading order, voice.
  5. A verdict, signed off, signed off with notes, or not signed off, with the problems that block it, worst first.

The record is a signed commit by design.b. Changes to a site are made by that site's agent; design.b reviews, briefs and signs off.

12. Founder and personal sites

Standing guidance from Dinis Cruz, 20 November 2026, for every new founder or personal site (source):

  1. Always show the designs. Five designs of the same facts, and a "Choose a design" control on every page, so visitors and the owner can move between them. What wins owners over is seeing that a site can be made in all these designs; then the only question is which one they prefer. Build the control as plain links with aria-current="page" on the design shown, no script, hidden in print, and keep every design's old address answering (design.b, from Kate Curtis-Evans round 4).
  2. The agent may pick the home design; the owner can change it.
  3. The milestone is the handover. The first design phase ends when the site is strong enough for its owner to carry on with their own Claude (images, words, choosing a design), with the handover, the owner's prompt and the steps to connect their Claude to GitHub written as part of the work.
  4. Ask the owner, not the operator: open questions (dates for figures, photo credits, which images may be used) go on a questions page for the owner.
  5. Owners need not sign commits; agents do.
  6. Sell the founder's story: the specialist who becomes a founder, building the tool their field was missing, with one of the five designs as a newsroom feature about it.
  7. Only what the owner has said: no invented fact, figure, client or quote; every figure dated; every photo credited.

For rating (rating.md), a founder or personal site reaches level 3 only with the design chooser on every page, and level 4 only with the questions page and the owner's handover written.

The handover is the objective (Dinis Cruz, 20 November 2026)

In his words, in design.b's session: "part of the objective for us is to do the handover ... a lot of the design stuff that we have is designed to do handover, is designed for them to add the materials, because we would always, never going to have the best materials, they're always going to have more". So:

Wow, not bland (Dinis Cruz, 20 November 2026)

On a founder site that was correct but plain: "it feels like websites created 10 years ago ... it needs to really have that wow factor, because when I show her the Silvio website, she said, wow. If I show her that now, she would have said, oh, this is interesting." So, for every founder and personal site:

Concept first, written down (Dinis Cruz, 20 November 2026)

Five variations of one website do not count ("just about looks like five, the same website with a couple of five different variations"). Before building, each site writes docs/designs.md, one section per design: its philosophy (a way of thinking about the owner), its visual narrative (what a visitor sees first, second, third, and why), its pipeline (how the facts become the page: material, layout system, interaction), its colour and type, and what makes it unlike the other four. Each design is built from its own section.

Use the technology: JavaScript, charts, visualisations, maps, 3D and frameworks are welcome when they serve the idea, served from the site itself (vendored, no CDN, nothing loaded from another host), working at a basic level without JavaScript, respecting reduced motion, and within the first-load budget. At least two designs are way out there: their own colour schemes and layouts, the whole screen, timelines, brands placed in different positions. One design is the plain, printable Brief.

Push, do not wait for sign-off (Dinis Cruz, 20 November 2026)

"I don't need to sign off the design. You push the sign off. You push it, and I see it on the website." Site agents and design.b push design rounds to dev and live without waiting for Dinis; he reviews them on the live site. Every site with five designs shows them all at once in its visual chooser (the panel of five screenshot cards), so they can be seen side by side.

The admin dashboard (Dinis Cruz, 20 November 2026)

Every customer site's /admin/ (guidelines 1.13) becomes "a proper admin dashboard... lots of graphs and powerful visualisations". It is the same generic page on every site: Kate Curtis-Evans's site is the pilot, and factory.b turns it into a seed page. Dinis gave this at about 16:50 UTC, relayed by the other design.b session.

What it shows, each as a panel with a heading: 1. Version: the commit live now, when it was built, and a link to it. 2. CI checks: the latest runs and their results. 3. Activity by author: commits over time, by author: the owner, the site's agent, design.b, and others. 4. Content and weight: pages, images, words, and first-load weight per page against the budget (section 9). 5. Quality history: accessibility results, contrast failures and overflow per commit, where they are recorded. 6. Design rounds and synthetic users: each round's rating and each run's look score, from design.b's data/rounds/<site>.json on design.agents.sovereignweb.site. Fetch it at build time, or link to it. 7. Agents: which agents have worked on the site, with their roles and their published keys. 8. Ask Claude: example prompts for the owner (change a word, add photos, choose a design) and for a visitor (ask about the owner's work), as on /agents/. 9. Visitors: a placeholder that says plainly that no visitor data is collected today (section 1.1: no tracking). It is filled only if the owner later chooses a privacy-respecting count.

How it is built: - Build-time data only. Every figure comes from files written at build: git log, CI results and design.b's JSON. Nothing is fetched from another host when a visitor opens the page. - No email addresses, and no private data. Show authors by name or role, never by email. - The chart library is vendored: served from the site itself, with a version pinned, and loaded with defer (section 9). No CDN. - Every chart has a data table behind it, reachable as a <details> "Show the data" or a linked table. Colour is never the only signal. Charts follow the site's light and dark tokens. - It works on a phone: charts reflow into one column at 390 px, with no sideways scroll; wide tables scroll inside their own focusable box. - It is noindex: <meta name="robots" content="noindex">. It is linked from the site (1.13), but kept out of search results.

design.b audits the dashboard like any other page, in all four views. It also checks that each chart's table matches its source data.