{
  "$description": "Well & Good design tokens in DTCG format. The source of truth for the brand. One green ramp read at two volumes (vivid and muted), one type scale and one spacing scale, with a dial per register: website, interface and academic. Components ask for roles; the register and the mode decide the value. CSS is generated from this file, never copied by hand.",
  "$extensions": {
    "tech.wellandgood": {
      "version": "0.2.0-draft",
      "updated": "2026-11-15",
      "source": "shared/brands/wellgoodco/system/tokens.json",
      "registers": {
        "website": "Bold and creative. Vivid ramp, type ratio 1.333, roomy spacing, 2rem grid.",
        "interface": "Accessible and discreet; the task comes first. Muted ramp, type ratio 1.2, compact spacing, 0.5rem grid.",
        "academic": "Restrained. The light interface colours without Lichen, type ratio 1.25, even spacing."
      },
      "dials": {
        "chroma": "The muted ramp is the vivid ramp at the same lightness and hue, with chroma x0.7 in the darks and x0.6 from Moss upwards.",
        "hue": "Lights and mids at hue 125, bending to about 135 at Moss and 147 in the darks. Greens stay between 120 and 150.",
        "type-ratio": "website 1.333, interface 1.2, academic 1.25. Step 0 is 1rem in every register.",
        "density": "website roomy, interface compact, academic even. See space.role."
      },
      "retired": {
        "onyx": "#000d01. Was a patch for Woodsmoke turning bright on vivid screens. Interfaces use Eucalyptus instead.",
        "bark": "Name dropped. #818179 is Ash.",
        "reserve": "#2f4a33 and #809681 are replaced by the muted ramp."
      },
      "contrast": {
        "pebble on woodsmoke": 13.9,
        "pebble on eucalyptus": 13.2,
        "neutral-400 on woodsmoke": 7.6,
        "holly on woodsmoke": 6.3,
        "lichen on woodsmoke": 15.5,
        "green-950 ink on stone": 13.6,
        "moss on stone": 10.0,
        "green-700 on stone": 6.2,
        "neutral-600 on stone": 5.3,
        "seasalt on moss": 12.0,
        "lichen on moss": 10.5
      }
    }
  },

  "color": {
    "$type": "color",
    "woodsmoke": { "$value": "#041606", "$description": "Website ground, dark mode. L17.9 C0.042 H147." },
    "eucalyptus": { "$value": "#0d1b10", "$description": "Interface ground, dark mode. Woodsmoke at 0.7 chroma; stays green on every screen." },
    "moss": { "$value": "#1d3a09", "$description": "Headings and primary action on light. Outlines on dark. L31.4 C0.082 H135." },
    "holly": { "$value": "#7ca300", "$description": "Links and primary action on the dark website. L66.2 C0.166 H125." },
    "sulfur": { "$value": "#bdf520", "$description": "The core brand colour: the ampersand in the logo, and every user action (hover, focus, press). It is never just there; it appears when someone acts, so it feels special. Never large display text or body text." },
    "lichen": { "$value": "#d1f78d", "$description": "The quiet signal at rest. Teeny tiny: a dot on dark, a marker behind dark text on light. Never text on light, never in academic work." },
    "pebble": { "$value": "#dcdfd8", "$description": "Text on dark: headings and body. Button fill in dark interfaces." },
    "seasalt": { "$value": "#f7faf2", "$description": "Raised cards on light. Text on Moss." },
    "ash": { "$value": "#818179", "$description": "Mid neutral. Control borders on light; never small text on dark." },
    "tar": { "$value": "#3a3b3a", "$description": "Dark neutral." }
  },

  "ramp": {
    "$type": "color",
    "$description": "Numbered stops are reached through roles, not used directly. Named colours are fixed stops on the ramp.",
    "green": {
      "950": { "$value": "{color.woodsmoke}" },
      "900": { "$value": "#07210b", "$description": "Marshland. Raised cards on the dark website." },
      "800": { "$value": "{color.moss}" },
      "700": { "$value": "#385c0f", "$description": "Links on the light website. L43." },
      "600": { "$value": "#577f10", "$description": "Secondary button outline on the dark website. L55." },
      "500": { "$value": "{color.holly}" },
      "100": { "$value": "{color.lichen}" },
      "ink": { "$value": "#0d1f12", "$description": "Deep green ink for text on light." }
    },
    "green-muted": {
      "950": { "$value": "{color.eucalyptus}" },
      "900": { "$value": "#132317", "$description": "Raised panels on the dark interface." },
      "850": { "$value": "#1a2b1d", "$description": "Selected row on the dark interface." },
      "800": { "$value": "#26371d", "$description": "Moss at 0.6. Lines on dark, primary action on light." },
      "700": { "$value": "#425831", "$description": "Links on the light interface." },
      "600": { "$value": "#627a44", "$description": "Secondary button outline." },
      "500": { "$value": "#859e57", "$description": "Links on the dark interface." }
    },
    "neutral": {
      "50": { "$value": "{color.seasalt}" },
      "75": { "$value": "#ebeee8", "$description": "Selected row on light." },
      "100": { "$value": "#e3e6e1", "$description": "Stone. Ground, light mode." },
      "150": { "$value": "{color.pebble}" },
      "200": { "$value": "#c9cdc5", "$description": "Card borders and rules on light." },
      "400": { "$value": "#a3a69e", "$description": "Secondary text on dark." },
      "500": { "$value": "{color.ash}" },
      "600": { "$value": "#5c5d58", "$description": "Secondary text on light." },
      "700": { "$value": "{color.tar}" }
    }
  },

  "role": {
    "$type": "color",
    "$description": "Every register has the same role names. Academic uses the interface roles, with a neutral-200 marker in place of Lichen. Text on the signal is always ramp.green.ink (--wg-on-signal).",
    "website": {
      "dark": {
        "ground": { "$value": "{color.woodsmoke}" },
        "raised": { "$value": "{ramp.green.900}" },
        "inset": { "$value": "{color.woodsmoke}" },
        "selected": { "$value": "{color.moss}", "$description": "Selected row; text stays Pebble (10:1)." },
        "line": { "$value": "{color.moss}" },
        "head": { "$value": "{color.pebble}" },
        "ink": { "$value": "{color.pebble}" },
        "quiet": { "$value": "{ramp.neutral.400}" },
        "link": { "$value": "{color.holly}" },
        "action": { "$value": "{color.holly}" },
        "on-action": { "$value": "{color.woodsmoke}" },
        "action-2-line": { "$value": "{ramp.green.600}" },
        "signal": { "$value": "{color.lichen}" },
        "signal-line": { "$value": "{color.lichen}", "$description": "No visible edge on dark." },
        "brand": { "$value": "{color.sulfur}", "$description": "The ampersand in the logo." },
        "interact": { "$value": "{color.sulfur}", "$description": "Hover, focus and press fills. Only on user action." },
        "on-interact": { "$value": "{color.woodsmoke}" },
        "focus": { "$value": "{color.sulfur}" },
        "grid": { "$value": "{color.pebble}", "$description": "At 3%." }
      },
      "light": {
        "ground": { "$value": "{ramp.neutral.100}" },
        "raised": { "$value": "{color.seasalt}" },
        "inset": { "$value": "{color.pebble}" },
        "selected": { "$value": "{ramp.neutral.75}" },
        "line": { "$value": "{ramp.neutral.200}" },
        "head": { "$value": "{color.moss}" },
        "ink": { "$value": "{ramp.green.ink}" },
        "quiet": { "$value": "{ramp.neutral.600}" },
        "link": { "$value": "{ramp.green.700}" },
        "action": { "$value": "{color.moss}" },
        "on-action": { "$value": "{color.seasalt}" },
        "action-2-line": { "$value": "{ramp.green.700}" },
        "signal": { "$value": "{color.lichen}", "$description": "Marker fill behind dark text, or inside a Moss block." },
        "signal-line": { "$value": "{color.holly}", "$description": "On light, anything in Lichen gets a solid 1px edge." },
        "brand": { "$value": "{color.sulfur}", "$description": "The ampersand in the logo." },
        "interact": { "$value": "{color.sulfur}", "$description": "Hover, focus and press fills. Only on user action." },
        "on-interact": { "$value": "{ramp.green.ink}" },
        "focus": { "$value": "{color.moss}" },
        "grid": { "$value": "{color.woodsmoke}", "$description": "At 3%; may need 4 to 5% to read like dark." }
      }
    },
    "interface": {
      "dark": {
        "ground": { "$value": "{color.eucalyptus}" },
        "raised": { "$value": "{ramp.green-muted.900}" },
        "inset": { "$value": "{color.eucalyptus}" },
        "selected": { "$value": "{ramp.green-muted.850}" },
        "line": { "$value": "{ramp.green-muted.800}" },
        "head": { "$value": "{color.pebble}" },
        "ink": { "$value": "{color.pebble}" },
        "quiet": { "$value": "{ramp.neutral.400}" },
        "link": { "$value": "{ramp.green-muted.500}" },
        "action": { "$value": "{color.pebble}" },
        "on-action": { "$value": "{color.eucalyptus}" },
        "action-2-line": { "$value": "{ramp.green-muted.600}" },
        "signal": { "$value": "{color.lichen}" },
        "signal-line": { "$value": "{color.lichen}", "$description": "No visible edge on dark." },
        "brand": { "$value": "{color.sulfur}", "$description": "The ampersand in the logo." },
        "interact": { "$value": "{color.sulfur}", "$description": "Hover, focus and press fills. Only on user action." },
        "on-interact": { "$value": "{color.woodsmoke}" },
        "focus": { "$value": "{color.sulfur}" },
        "grid": { "$value": "{color.pebble}", "$description": "At 3%." }
      },
      "light": {
        "ground": { "$value": "{ramp.neutral.100}" },
        "raised": { "$value": "{color.seasalt}" },
        "inset": { "$value": "{color.pebble}" },
        "selected": { "$value": "{ramp.neutral.75}" },
        "line": { "$value": "{ramp.neutral.200}" },
        "head": { "$value": "{ramp.green.ink}" },
        "ink": { "$value": "{ramp.green.ink}" },
        "quiet": { "$value": "{ramp.neutral.600}" },
        "link": { "$value": "{ramp.green-muted.700}" },
        "action": { "$value": "{ramp.green-muted.800}" },
        "on-action": { "$value": "{color.seasalt}" },
        "action-2-line": { "$value": "{ramp.green-muted.600}" },
        "signal": { "$value": "{color.lichen}", "$description": "Marker fill behind dark text. Not in academic work." },
        "signal-line": { "$value": "{color.holly}", "$description": "On light, anything in Lichen gets a solid 1px edge." },
        "brand": { "$value": "{color.sulfur}", "$description": "The ampersand in the logo." },
        "interact": { "$value": "{color.sulfur}", "$description": "Hover, focus and press fills. Only on user action." },
        "on-interact": { "$value": "{ramp.green.ink}" },
        "focus": { "$value": "{ramp.green-muted.800}" },
        "grid": { "$value": "{color.woodsmoke}", "$description": "At 3%." }
      }
    }
  },

  "chart": {
    "$description": "Data colours, by mode; every register uses the same set. Mostly grey and green. Series take the fixed order and are never cycled: up to four, then fold the rest into Other or small multiples. Identity is never colour alone: a legend from two series, direct labels up to four. Status colours mark state only, always with an icon and a word, and never stand in for a series. Hover and selection on a chart use Sulfur (--wg-interact), like every other action. Validated 2026-11-16 against woodsmoke, eucalyptus, Stone and seasalt: every pair of series passes colour-blind and normal-vision separation; contrast passes, with dark series 3 (Moss) carried by its Pebble edge; the two distinct-hue checks fail by design.",
    "$type": "color",
    "dark": {
      "series-1": { "$value": "{color.holly}" },
      "series-2": { "$value": "{color.pebble}" },
      "series-3": { "$value": "{color.moss}", "$description": "Dark fill; always drawn with its Pebble edge." },
      "series-3-edge": { "$value": "{color.pebble}", "$description": "1px edge on every series-3 mark and legend swatch." },
      "series-4": { "$value": "{ramp.neutral.400}" },
      "seq-1": { "$value": "{color.moss}", "$description": "Sequential: one green, low to high." },
      "seq-2": { "$value": "{ramp.green.700}" },
      "seq-3": { "$value": "{ramp.green.600}" },
      "seq-4": { "$value": "{color.holly}" },
      "seq-5": { "$value": "{color.lichen}" },
      "seq-1-edge": { "$value": "{color.pebble}", "$description": "1px edge on seq-1, the step closest to the ground." },
      "seq-2-edge": { "$value": "transparent", "$description": "No edge." },
      "good": { "$value": "{color.holly}" },
      "warning": { "$value": "#e3a72f" },
      "critical": { "$value": "#f0705a" },
      "disabled": { "$value": "{ramp.neutral.600}", "$description": "Low contrast on purpose; disabled items are exempt." }
    },
    "light": {
      "series-1": { "$value": "{ramp.green.600}" },
      "series-2": { "$value": "{color.tar}" },
      "series-3": { "$value": "{color.ash}" },
      "series-3-edge": { "$value": "{color.ash}", "$description": "Same as the fill on light; no visible edge." },
      "series-4": { "$value": "{color.moss}" },
      "seq-1": { "$value": "#dfe8cf", "$description": "Sequential: one green, low to high." },
      "seq-2": { "$value": "#a9c27a" },
      "seq-1-edge": { "$value": "{color.holly}", "$description": "1px edge on seq-1, a pale step." },
      "seq-2-edge": { "$value": "{color.holly}", "$description": "1px edge on seq-2, a pale step." },
      "seq-3": { "$value": "{ramp.green.600}" },
      "seq-4": { "$value": "{ramp.green.700}" },
      "seq-5": { "$value": "{color.moss}" },
      "good": { "$value": "{ramp.green.700}" },
      "warning": { "$value": "#9a6200" },
      "critical": { "$value": "#b3261e" },
      "disabled": { "$value": "{ramp.neutral.400}", "$description": "Low contrast on purpose; disabled items are exempt." }
    }
  },

  "font": {
    "family": {
      "$type": "fontFamily",
      "display": { "$value": ["ZT Talk", "system-ui", "sans-serif"], "$description": "Headings 1 to 3 in every register. Black 900 on the website, Bold 700 in interfaces and academic. Alternate a, f, g and ampersand baked in." },
      "body": { "$value": ["Pangea Text", "system-ui", "sans-serif"], "$description": "Body, small text and heading 4 down (SemiBold 600)." },
      "note": { "$value": ["Architect Pro Cap", "cursive"], "$description": "Hand-made notes, content layer only. All caps, 0.14em tracking, never below 1rem." }
    }
  },

  "type": {
    "$description": "One stepped scale. size(step) = 1rem x ratio^step. Line heights round up to the 0.25rem rhythm. Small text never goes below 0.875rem.",
    "ratio": {
      "$type": "number",
      "website": { "$value": 1.333 },
      "interface": { "$value": 1.2 },
      "academic": { "$value": 1.25 }
    },
    "weight": {
      "$type": "fontWeight",
      "heading-website": { "$value": 900 },
      "heading-interface": { "$value": 700 },
      "heading-academic": { "$value": 700 },
      "heading-4": { "$value": 600, "$description": "Pangea SemiBold, all registers." }
    },
    "step": {
      "$description": "Which step each role takes per register.",
      "website": { "display": 5, "h1": 4, "h2": 3, "h3": 2, "h4": 1, "body": 0, "small": -1 },
      "interface": { "h1": 3, "h2": 2, "h3": 1, "h4": 0, "body": 0, "small": -1 },
      "academic": { "h1": 3, "h2": 2, "h3": 1, "h4": 0, "body": 0, "small": -1 }
    },
    "line-height": {
      "$type": "number",
      "body": { "$value": 1.5 },
      "heading": { "$value": 1.25, "$description": "1.05 from 2rem up." }
    },
    "small-floor": { "$type": "dimension", "$value": { "value": 0.875, "unit": "rem" } },
    "measure": { "$type": "dimension", "$value": { "value": 75, "unit": "ch" }, "$description": "Reading width for Pangea at 1rem, every register." },
    "note": { "$type": "typography", "$value": { "fontFamily": "{font.family.note}", "fontWeight": 400, "fontSize": { "value": 1, "unit": "rem" }, "lineHeight": 1.5, "letterSpacing": { "value": 0.14, "unit": "em" } } }
  },

  "space": {
    "$type": "dimension",
    "$description": "One scale on a 0.25rem base. Steps are named by size in quarter rems.",
    "1": { "$value": { "value": 0.25, "unit": "rem" } },
    "2": { "$value": { "value": 0.5, "unit": "rem" } },
    "3": { "$value": { "value": 0.75, "unit": "rem" } },
    "4": { "$value": { "value": 1, "unit": "rem" } },
    "6": { "$value": { "value": 1.5, "unit": "rem" } },
    "8": { "$value": { "value": 2, "unit": "rem" } },
    "12": { "$value": { "value": 3, "unit": "rem" } },
    "16": { "$value": { "value": 4, "unit": "rem" } },
    "24": { "$value": { "value": 6, "unit": "rem" } },
    "32": { "$value": { "value": 8, "unit": "rem" } },
    "role": {
      "website": { "inline": "{space.3}", "stack": "{space.6}", "pad": "{space.8}", "gap": "{space.8}", "section": "{space.32}", "gutter": "{space.16}", "gutter-narrow": "{space.6}" },
      "interface": { "inline": "{space.3}", "stack": "{space.4}", "pad": "{space.8}", "gap": "{space.6}", "section": "{space.16}", "gutter": "{space.6}", "gutter-narrow": "{space.4}" },
      "academic": { "inline": "{space.3}", "stack": "{space.6}", "pad": "{space.8}", "gap": "{space.6}", "section": "{space.24}", "gutter": "{space.8}", "gutter-narrow": "{space.6}" }
    }
  },

  "grid": {
    "$type": "dimension",
    "website": { "$value": { "value": 2, "unit": "rem" }, "$description": "Card edges, gaps and padding land on the 2rem lines; cards take uneven spans." },
    "interface": { "$value": { "value": 0.5, "unit": "rem" }, "$description": "Every box edge lands on the 0.5rem cell." },
    "opacity": { "$type": "number", "$value": 0.03, "$description": "Grid lines are 1px at 3% of the role.grid colour, whatever the cell size." }
  },

  "border": {
    "hairline": { "$type": "dimension", "$value": { "value": 1, "unit": "px" } },
    "radius": {
      "$type": "dimension",
      "ground": { "$value": { "value": 0, "unit": "rem" }, "$description": "The page ground and the header bar stay square." },
      "content": { "$value": { "value": 0.5, "unit": "rem" }, "$description": "Everything that sits on the ground: panels, previews, cards, buttons, inputs, badges, markers. One interface grid cell. No pills, no squircles." }
    }
  },

  "focus": {
    "ring": { "$type": "dimension", "$value": { "value": 0.125, "unit": "rem" }, "$description": "In role.focus. The same on every control." },
    "offset": { "$type": "dimension", "$value": { "value": 0.125, "unit": "rem" } }
  },

  "motion": {
    "$description": "Almost no motion. Only on direct interaction. Reduced motion keeps the state change and drops the movement.",
    "button": {
      "duration": { "$type": "duration", "$value": { "value": 500, "unit": "ms" }, "$description": "Hover, focus and active: the button tilts." },
      "tilt": { "$type": "number", "$value": 6, "$description": "Degrees, clockwise (the button dips downward), around its centre. Same as doingwellandgood.com and mariaarangokure.com." }
    },
    "control": {
      "duration": { "$type": "duration", "$value": { "value": 200, "unit": "ms" } }
    },
    "enter": {
      "duration": { "$type": "duration", "$value": { "value": 320, "unit": "ms" } },
      "easing": { "$type": "cubicBezier", "$value": [0.2, 0.7, 0.2, 1] }
    }
  }
}
