v0.2.0-draft

For AI

Everything a model needs to work with the brand, on one page.

Files for agents

FileUse
llms.txtThis page as plain text, for any model
tokens.jsonEvery value, typed (DTCG)
wg-tokens.cssThe variables to use in code

The whole brand in plain rules

# Well & Good brand, version 0.2.0-draft

Source of truth: https://brand.wellandgood.tech/tokens.json (DTCG). If anything here disagrees with it, the token file is right.
Load in a page: https://brand.wellandgood.tech/v/0.2.0-draft/fonts.css, wg-tokens.css, wg.css. Set data-register and data-theme on <html>.

## Registers
- website: bold and roomy. Vivid green ramp, type ratio 1.333, ZT Talk Black headings, 2rem grid.
- interface: tools, dashboards, portals, docs. Muted ramp, ratio 1.2, ZT Talk Bold, compact spacing, 0.5rem grid. The task leads.
- academic: papers, talks, CVs. Light ground, ratio 1.25, ZT Talk Bold, no Lichen.

## Colour roles (use the CSS variable, never the hex)
- website dark: --wg-ground #041606; --wg-raised #07210b; --wg-inset #041606; --wg-selected #1d3a09; --wg-line #1d3a09; --wg-head #dcdfd8; --wg-ink #dcdfd8; --wg-quiet #a3a69e; --wg-link #7ca300; --wg-action #7ca300; --wg-on-action #041606; --wg-action-2-line #577f10; --wg-signal #d1f78d; --wg-signal-line #d1f78d; --wg-brand #bdf520; --wg-interact #bdf520; --wg-on-interact #041606; --wg-focus #bdf520; --wg-grid #dcdfd8
- website light: --wg-ground #e3e6e1; --wg-raised #f7faf2; --wg-inset #dcdfd8; --wg-selected #ebeee8; --wg-line #c9cdc5; --wg-head #1d3a09; --wg-ink #0d1f12; --wg-quiet #5c5d58; --wg-link #385c0f; --wg-action #1d3a09; --wg-on-action #f7faf2; --wg-action-2-line #385c0f; --wg-signal #d1f78d; --wg-signal-line #7ca300; --wg-brand #bdf520; --wg-interact #bdf520; --wg-on-interact #0d1f12; --wg-focus #1d3a09; --wg-grid #041606
- interface dark: --wg-ground #0d1b10; --wg-raised #132317; --wg-inset #0d1b10; --wg-selected #1a2b1d; --wg-line #26371d; --wg-head #dcdfd8; --wg-ink #dcdfd8; --wg-quiet #a3a69e; --wg-link #859e57; --wg-action #dcdfd8; --wg-on-action #0d1b10; --wg-action-2-line #627a44; --wg-signal #d1f78d; --wg-signal-line #d1f78d; --wg-brand #bdf520; --wg-interact #bdf520; --wg-on-interact #041606; --wg-focus #bdf520; --wg-grid #dcdfd8
- interface light: --wg-ground #e3e6e1; --wg-raised #f7faf2; --wg-inset #dcdfd8; --wg-selected #ebeee8; --wg-line #c9cdc5; --wg-head #0d1f12; --wg-ink #0d1f12; --wg-quiet #5c5d58; --wg-link #425831; --wg-action #26371d; --wg-on-action #f7faf2; --wg-action-2-line #627a44; --wg-signal #d1f78d; --wg-signal-line #7ca300; --wg-brand #bdf520; --wg-interact #bdf520; --wg-on-interact #0d1f12; --wg-focus #26371d; --wg-grid #041606
- academic dark: --wg-ground #0d1b10; --wg-raised #132317; --wg-inset #0d1b10; --wg-selected #1a2b1d; --wg-line #26371d; --wg-head #dcdfd8; --wg-ink #dcdfd8; --wg-quiet #a3a69e; --wg-link #859e57; --wg-action #dcdfd8; --wg-on-action #0d1b10; --wg-action-2-line #627a44; --wg-signal #c9cdc5; --wg-signal-line #d1f78d; --wg-brand #bdf520; --wg-interact #bdf520; --wg-on-interact #041606; --wg-focus #bdf520; --wg-grid #dcdfd8
- academic light: --wg-ground #e3e6e1; --wg-raised #f7faf2; --wg-inset #dcdfd8; --wg-selected #ebeee8; --wg-line #c9cdc5; --wg-head #0d1f12; --wg-ink #0d1f12; --wg-quiet #5c5d58; --wg-link #425831; --wg-action #26371d; --wg-on-action #f7faf2; --wg-action-2-line #627a44; --wg-signal #c9cdc5; --wg-signal-line #7ca300; --wg-brand #bdf520; --wg-interact #bdf520; --wg-on-interact #0d1f12; --wg-focus #26371d; --wg-grid #041606

## Rules
- Sulfur #bdf520 is the core brand colour: the ampersand in the logo, and every user action (hover, focus, press fills, --wg-interact). Never shown at rest, never large display or body text.
- Lichen #d1f78d is the quiet signal at rest and stays tiny: a dot on dark, a marker behind dark text on light. Never text on light, never in academic work.
- Onyx and Bark are retired.
- No filled mid-green surfaces on dark. Raised cards are one barely lifted step with an outline.
- Headings 1 to 3 are ZT Talk in every register. Heading 4 down, body and small text are Pangea Text. Architect Pro Cap only for hand-made notes.
- Body 1rem, line height 1.5, measure 75ch. Small text never below 0.875rem.
- The page ground and header bar are square; everything on them (panels, previews, cards, buttons, fields, badges, markers) has 0.5rem corners. No pills.
- The ground carries a 1px square grid at 3%.
- Motion only on direct interaction: buttons tilt 6 degrees over 500ms and fill Sulfur. Reduced motion removes the tilt and keeps the colour.
- No gradients, glassmorphism, drop shadows, eyebrow labels, em dashes, botanical imagery, sage, cream, beige or terracotta.
- Sentence case everywhere. WCAG 2.2 AA minimum.
- Charts: use --wg-chart-series-1 to 4 in that order, never cycled, with --wg-chart-series-3-edge as a 1px edge on every series-3 mark; more than four folds into Other or small multiples. --wg-chart-seq-1 to 5 for one-measure ramps; draw seq-1 and seq-2 with their 1px --wg-chart-seq-1-edge and --wg-chart-seq-2-edge (Pebble on the first dark step, Holly on the two pale light steps). --wg-chart-good, warning, critical and disabled for state only, always with an icon and a word. Legend from two series; one axis per chart; hover in Sulfur.

## Layouts
- Start every page, deck, post, video card or email from a layout at https://brand.wellandgood.tech/layouts.html (sources under https://brand.wellandgood.tech/layouts/source/). Keep the structure and classes, change the words. Do not design new chrome.
- Registers are dress codes: website is the Met Gala, interface is jeans and a t-shirt, academic is a suit.
- Slides, posts and video cards are .wg-frame elements sized in rem; at a 200% root they render at 1920x1080, 1080x1080, 1080x1350 and 1080x1920.
- Email is the one place token values are written in, because email clients ignore stylesheets. Take the built template; never type the colours.

## Voice
- One practitioner speaking in first person. "We" is the client and me.
- Five principles: accessibility and inclusion; sustainability and impact; truth and transparency; privacy and security; health and wellbeing.
- Critique systems, never a client's budget or readiness.

MCP server

Not set up yet. When it exists it will answer the same questions from the same token file: get_full_context, get_color_roles, get_type, get_spacing, get_voice, get_assets.