diff --git a/apps/website/.vitepress/theme/Landing.vue b/apps/website/.vitepress/theme/Landing.vue
index 97f1885..9c889e6 100644
--- a/apps/website/.vitepress/theme/Landing.vue
+++ b/apps/website/.vitepress/theme/Landing.vue
@@ -95,7 +95,7 @@ onMounted(() => {
           <a class="navlink nav-hide" href="#philosophy">Philosophy</a>
           <a class="navlink nav-hide" href="#projects" style="margin-right:6px">Projects</a>
           <ClientOnly>
-            <button type="button" class="btv-toggle" :title="isDark ? 'Switch to light' : 'Switch to dark'" :aria-label="isDark ? 'Switch to light theme' : 'Switch to dark theme'" @click="toggleAppearance">
+            <button type="button" class="btv-toggle" :title="isDark ? 'Switch to light' : 'Switch to dark'" :aria-label="isDark ? 'Switch to light theme' : 'Switch to dark theme'" :aria-pressed="isDark" @click="toggleAppearance">
               <svg v-if="isDark" width="17" height="17" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="4.2"/><path d="M12 2.5v2M12 19.5v2M4.8 4.8l1.4 1.4M17.8 17.8l1.4 1.4M2.5 12h2M19.5 12h2M4.8 19.2 6.2 17.8M17.8 6.2 19.2 4.8"/></svg>
               <svg v-else width="17" height="17" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M20 14.5A8 8 0 1 1 9.5 4 6.4 6.4 0 0 0 20 14.5Z"/></svg>
             </button>
@@ -232,7 +232,6 @@ onMounted(() => {
 
 <style scoped>
 .btv {
-  --btv-glass: rgba(21, 16, 28, 0.66);
   --btv-hover: rgba(255, 255, 255, 0.05);
   --btv-pill: rgba(255, 255, 255, 0.04);
   --btv-footer: rgba(0, 0, 0, 0.2);
@@ -242,28 +241,17 @@ onMounted(() => {
   font-family: var(--sans);
 }
 
-/* Light mode (system preference or the header toggle) — scoped to the landing */
+/* Light mode (system / toggle): surfaces, text and accent-as-text come from the
+   shared tokens (tokens.css :root:not(.dark)); only these landing-local
+   overlays — header/nav washes, pills, footer tint — flip here. */
 :global(html:not(.dark)) .btv {
-  --bg: #fbf7fb;
-  --bg-grad: #f4e7f0;
-  --card: #ffffff;
-  --card-soft: #f6eff4;
-  --border: rgba(26, 12, 20, 0.1);
-  --border-2: rgba(26, 12, 20, 0.16);
-  --text: #241a22;
-  --muted: #6b5e68;
-  --faint: #9c8f99;
-  --accent: #c13c79;
-  --shadow-card: 0 20px 45px -28px rgba(142, 26, 82, 0.28);
-  --shadow-toast: 0 18px 40px -18px rgba(142, 26, 82, 0.2);
-  --btv-glass: rgba(251, 247, 251, 0.72);
   --btv-hover: rgba(26, 12, 20, 0.05);
   --btv-pill: rgba(26, 12, 20, 0.035);
   --btv-footer: rgba(26, 12, 20, 0.025);
 }
 :global(html:not(.dark)) .btv-glow { opacity: 0.55; }
 
-.btv-pink { color: var(--accent); }
+.btv-pink { color: var(--text-accent); }
 .btv-toggle {
   display: inline-flex; align-items: center; justify-content: center;
   width: 38px; height: 38px;
@@ -277,7 +265,7 @@ onMounted(() => {
 .btv-head {
   position: sticky; top: 0; z-index: 50;
   backdrop-filter: blur(14px); -webkit-backdrop-filter: blur(14px);
-  background: var(--btv-glass);
+  background: var(--glass);
   border-bottom: 1px solid var(--border);
 }
 .btv-head-inner { max-width: 1180px; margin: 0 auto; padding: 0 28px; height: 68px; display: flex; align-items: center; justify-content: space-between; gap: 24px; }
@@ -307,7 +295,7 @@ onMounted(() => {
 /* Sections */
 .btv-section { max-width: 1180px; margin: 0 auto; padding: 64px 28px 40px; }
 .btv-narrow { padding: 34px 28px 8px; }
-.btv-eyebrow { margin: 0; font-family: var(--mono); font-size: 13px; letter-spacing: 1.5px; text-transform: uppercase; color: var(--accent); }
+.btv-eyebrow { margin: 0; font-family: var(--mono); font-size: 13px; letter-spacing: 1.5px; text-transform: uppercase; color: var(--text-accent); }
 .btv-h2 { margin: 14px 0 0; font-weight: 800; letter-spacing: -1px; line-height: 1.08; font-size: clamp(28px, 4vw, 40px); }
 .btv-h2-wide { max-width: 680px; }
 .btv-section-lead { margin: 16px 0 0; max-width: 640px; font-size: 16.5px; line-height: 1.65; color: var(--muted); }
@@ -316,7 +304,7 @@ onMounted(() => {
 .btv-prin { display: grid; grid-template-columns: repeat(3, minmax(0, 1fr)); gap: 18px; margin-top: 34px; }
 .btv-prin-card { background: var(--card); border: 1px solid var(--border); border-radius: 16px; padding: 22px; transition: transform .2s ease, border-color .2s ease; }
 .btv-prin-card:hover { transform: translateY(-3px); border-color: var(--border-2); }
-.btv-prin-num { width: 38px; height: 38px; border-radius: 10px; display: flex; align-items: center; justify-content: center; background: rgba(224,88,154,0.12); border: 1px solid rgba(224,88,154,0.25); color: var(--accent); font-family: var(--mono); font-weight: 600; font-size: 15px; }
+.btv-prin-num { width: 38px; height: 38px; border-radius: 10px; display: flex; align-items: center; justify-content: center; background: var(--accent-wash); border: 1px solid var(--accent-line); color: var(--text-accent); font-family: var(--mono); font-weight: 600; font-size: 15px; }
 .btv-prin-title { margin: 16px 0 0; font-weight: 700; font-size: 18px; letter-spacing: -0.3px; color: var(--text); }
 .btv-prin-body { margin: 9px 0 0; font-size: 14.5px; line-height: 1.6; color: var(--muted); }
 
@@ -328,10 +316,10 @@ onMounted(() => {
 .btv-pcard-top { display: flex; align-items: center; justify-content: space-between; gap: 12px; }
 .btv-pcard-id { display: flex; align-items: center; gap: 11px; min-width: 0; }
 .btv-logo { display: block; flex: none; }
-.btv-tag { display: inline-flex; align-items: center; font-family: var(--mono); font-size: 11.5px; font-weight: 600; letter-spacing: 0.5px; text-transform: uppercase; color: var(--accent); background: rgba(224,88,154,0.1); border: 1px solid rgba(224,88,154,0.22); padding: 5px 10px; border-radius: 999px; }
+.btv-tag { display: inline-flex; align-items: center; font-family: var(--mono); font-size: 11.5px; font-weight: 600; letter-spacing: 0.5px; text-transform: uppercase; color: var(--text-accent); background: var(--accent-wash); border: 1px solid var(--accent-line); padding: 5px 10px; border-radius: 999px; }
 .btv-stars { display: inline-flex; align-items: center; gap: 5px; font-size: 13px; font-weight: 600; color: var(--faint); }
 .btv-pname { margin: 18px 0 0; font-weight: 800; font-size: 23px; letter-spacing: -0.6px; color: var(--text); }
-.btv-pkg { display: inline-block; margin: 7px 0 0; font-family: var(--mono); font-size: 13px; color: var(--accent); background: none; padding: 0; }
+.btv-pkg { display: inline-block; margin: 7px 0 0; font-family: var(--mono); font-size: 13px; color: var(--text-accent); background: none; padding: 0; }
 .btv-blurb { margin: 14px 0 0; min-height: 92px; font-size: 14.5px; line-height: 1.6; color: var(--muted); }
 .btv-points { list-style: none; margin: 18px 0 0; padding: 0; display: flex; flex-direction: column; gap: 9px; }
 .btv-points li { display: flex; align-items: flex-start; gap: 9px; font-size: 14px; line-height: 1.4; color: var(--text); }
@@ -345,7 +333,7 @@ onMounted(() => {
 .btv-foot-a { display: inline-flex; align-items: center; gap: 7px; text-decoration: none; color: var(--text); font-weight: 700; font-size: 14px; }
 .btv-foot-muted { color: var(--muted); }
 .repolink { transition: color .15s; }
-.repolink:hover { color: var(--accent); }
+.repolink:hover { color: var(--text-accent); }
 
 /* CTA banner */
 .btv-cta-wrap { padding: 30px 28px 80px; }
@@ -362,7 +350,7 @@ onMounted(() => {
 .btv-foot-col { display: flex; flex-direction: column; gap: 11px; }
 .btv-foot-h { margin: 0 0 4px; font-size: 12px; letter-spacing: 1px; text-transform: uppercase; color: var(--faint); font-weight: 700; }
 .foot-link { color: var(--muted); text-decoration: none; font-size: 14px; transition: color .15s; }
-.foot-link:hover { color: var(--accent); }
+.foot-link:hover { color: var(--text-accent); }
 .btv-foot-bottom { max-width: 1180px; margin: 0 auto; padding: 18px 28px 34px; border-top: 1px solid var(--border); display: flex; flex-wrap: wrap; gap: 10px; align-items: center; justify-content: space-between; font-size: 13px; color: var(--faint); }
 .btv-foot-muted2 { color: var(--muted); }
 .btv-foot-mono { font-family: var(--mono); font-size: 12px; color: var(--faint); }
diff --git a/packages/theme/package.json b/packages/theme/package.json
index 3d16559..58c72c7 100644
--- a/packages/theme/package.json
+++ b/packages/theme/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@btravstack/theme",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Shared VitePress theme and design tokens for btravstack sites",
   "license": "MIT",
   "author": "Benoit TRAVERS",
@@ -11,7 +11,9 @@
     "url": "git+https://github.com/btravstack/btravstack.github.io.git",
     "directory": "packages/theme"
   },
-  "files": ["dist"],
+  "files": [
+    "dist"
+  ],
   "exports": {
     ".": {
       "types": "./dist/index.d.mts",
@@ -20,7 +22,9 @@
     "./style.css": "./dist/style.css",
     "./tokens.css": "./dist/tokens.css"
   },
-  "sideEffects": ["**/*.css"],
+  "sideEffects": [
+    "**/*.css"
+  ],
   "publishConfig": {
     "access": "public"
   },
diff --git a/packages/theme/src/style.css b/packages/theme/src/style.css
index a7d26c1..58dcc54 100644
--- a/packages/theme/src/style.css
+++ b/packages/theme/src/style.css
@@ -1,86 +1,76 @@
 /*
  * @btravstack/theme — VitePress style entry.
  *
- * Maps the btravstack design tokens onto VitePress's own `--vp-*` theme
- * variables so every btravstack site (this website + the docs sites) shares
- * one look. Pulled in automatically by the theme's index.ts; consumers can
- * also import it directly as `@btravstack/theme/style.css`.
+ * Maps the btravstack design tokens onto VitePress's own `--vp-*` variables so
+ * every btravstack site (the website + the docs sites) shares one look.
+ * Because the semantic tokens (--bg, --text, --text-accent, …) flip per scheme
+ * in tokens.css, this mapping is written once and adapts automatically:
+ *   - dark  → the btravstack plum surfaces, pink links
+ *   - light → clean warm-white surfaces, brand darkened to deep beetroot
+ *             (--text-accent) so links/headings pass WCAG-AA on white
  *
- * Theming covers BOTH color schemes, so it's safe to let VitePress follow
- * the visitor's OS preference (its default, `appearance: true`):
- *   - dark  → adopts the btravstack surface palette
- *   - light → keeps VitePress's light surfaces, with the brand darkened to
- *             the deep beetroot so links/headings pass WCAG-AA on white.
+ * The `:root:root` selector raises specificity to (0,2,0) so the mapping wins
+ * over VitePress's own `:root` / `.dark` defaults regardless of load order.
  */
 @import "./fonts.css";
 @import "./tokens.css";
 
-/* ── Brand defaults + typography (both schemes) ────────────────── */
-/* `:root:root` / `:root.dark` raise specificity to (0,2,0) so these win
-   over VitePress's own `:root` / `.dark` defaults regardless of the order
-   the remote @import lands in the cascade. */
 :root:root {
-  --vp-c-brand-1: var(--accent);
-  --vp-c-brand-2: var(--bt-magenta);
-  --vp-c-brand-3: var(--accent-deep);
-  --vp-c-brand-soft: rgba(var(--accent-rgb), 0.14);
-  --vp-c-brand: var(--accent); /* legacy alias */
+  /* Surfaces / text / dividers — scheme-aware via the semantic tokens */
+  --vp-c-bg:      var(--bg);
+  --vp-c-bg-alt:  var(--card);
+  --vp-c-bg-soft: var(--card-soft);
+  --vp-c-bg-elv:  var(--card);
+
+  --vp-c-text-1: var(--text);
+  --vp-c-text-2: var(--muted);
+  --vp-c-text-3: var(--faint);
+
+  --vp-c-divider: var(--border);
+  --vp-c-border:  var(--border-2);
+  --vp-c-gutter:  var(--border);
+
+  /* Brand — links/active use accent-as-TEXT (darkens on light for AA) */
+  --vp-c-brand-1:    var(--text-accent);
+  --vp-c-brand-2:    var(--bt-pink-soft);
+  --vp-c-brand-3:    var(--accent-deep);
+  --vp-c-brand-soft: rgba(var(--accent-rgb), 0.16);
+  --vp-c-brand:      var(--text-accent); /* legacy alias */
+
+  /* Inline code — accent-as-text so it stays readable on the (scheme-aware)
+     code inset: pink on dark, deep beetroot on the light code wash */
+  --vp-code-color: var(--text-accent);
+  --vp-code-bg:    var(--code-bg);
 
   --vp-font-family-base: var(--sans);
   --vp-font-family-mono: var(--mono);
 
-  /* Solid brand buttons — dark ink on the pink fill, readable in both schemes */
-  --vp-button-brand-bg: var(--accent);
-  --vp-button-brand-text: var(--accent-contrast);
-  --vp-button-brand-border: transparent;
-  --vp-button-brand-hover-bg: var(--bt-magenta);
-  --vp-button-brand-hover-text: var(--accent-contrast);
+  /* Solid brand buttons — dark ink on the pink FILL, readable in both schemes */
+  --vp-button-brand-bg:           var(--accent);
+  --vp-button-brand-text:         var(--accent-contrast);
+  --vp-button-brand-border:       transparent;
+  --vp-button-brand-hover-bg:     var(--bt-magenta);
+  --vp-button-brand-hover-text:   var(--accent-contrast);
   --vp-button-brand-hover-border: transparent;
-  --vp-button-brand-active-bg: var(--accent-deep);
-  --vp-button-brand-active-text: var(--bt-cream);
+  --vp-button-brand-active-bg:    var(--accent-deep);
+  --vp-button-brand-active-text:  var(--bt-cream);
   --vp-button-brand-active-border: transparent;
 
+  /* Custom-block (admonition) tints */
+  --vp-custom-block-tip-bg:     rgba(var(--green-rgb), 0.08);
+  --vp-custom-block-tip-border: rgba(var(--green-rgb), 0.30);
+  --vp-custom-block-tip-text:   var(--text-green);
+  --vp-custom-block-warning-bg:     rgba(var(--accent-rgb), 0.08);
+  --vp-custom-block-warning-border: var(--accent-line);
+  --vp-custom-block-warning-text:   var(--text-accent);
+
   /* Home hero: gradient name + beetroot glow behind the logo */
   --vp-home-hero-name-color: transparent;
-  --vp-home-hero-name-background: linear-gradient(120deg, var(--accent), var(--bt-pink-soft));
+  --vp-home-hero-name-background: linear-gradient(120deg, var(--text-accent), var(--bt-pink-soft));
   --vp-home-hero-image-background-image: radial-gradient(closest-side, rgba(var(--accent-rgb), 0.30), transparent 72%);
   --vp-home-hero-image-filter: blur(8px);
 }
 
-/* ── Light scheme: darken the brand so it passes WCAG-AA on white ── */
-:root:not(.dark) {
-  --vp-c-brand-1: var(--accent-deep);  /* link / active text — ~7:1 on white */
-  --vp-c-brand-2: var(--bt-deep-2);    /* hover, a touch darker */
-  --vp-c-brand-3: var(--accent-deep);
-  --vp-c-brand-soft: rgba(var(--accent-rgb), 0.10);
-  /* deeper gradient so the hero name reads on a light background */
-  --vp-home-hero-name-background: linear-gradient(120deg, var(--accent-deep), var(--bt-magenta));
-}
-
-/* ── Dark scheme: btravstack surfaces (matches the landing page) ── */
-:root.dark {
-  --vp-c-bg: var(--bg);
-  --vp-c-bg-alt: var(--card);
-  --vp-c-bg-soft: var(--card-soft);
-  --vp-c-bg-elv: var(--card);
-
-  --vp-c-text-1: var(--text);
-  --vp-c-text-2: var(--muted);
-  --vp-c-text-3: var(--faint);
-
-  --vp-c-divider: var(--border);
-  --vp-c-border: var(--border-2);
-  --vp-c-gutter: var(--border);
-
-  --vp-c-brand-1: var(--accent);       /* pink reads great on dark */
-  --vp-c-brand-2: var(--bt-pink-soft);
-  --vp-c-brand-soft: rgba(var(--accent-rgb), 0.16);
-
-  /* Inline + block code */
-  --vp-code-color: var(--bt-pink-soft);
-  --vp-code-bg: rgba(0, 0, 0, 0.35);
-}
-
 /* ── Playful flourishes — shared across every btravstack site ───── */
 
 /* Home hero: a soft beetroot glow + a gently floating logo */
diff --git a/packages/theme/src/tokens.css b/packages/theme/src/tokens.css
index 06cb7dc..4e4fa01 100644
--- a/packages/theme/src/tokens.css
+++ b/packages/theme/src/tokens.css
@@ -1,55 +1,102 @@
 /*
  * btravstack design tokens — the single source of truth.
- * Every surface (this landing page + the VitePress docs sites) derives
- * its look from these CSS custom properties. Change a value here, bump
- * the version, and every consumer updates.
  *
- * Naming: semantic tokens (--bg, --text, --accent) are what you should
- * reference in app code. The raw --bt-* brand palette underneath them is
- * the provenance, exposed so adapters (e.g. VitePress) can remap freely.
+ * Mirrors the btravstack Design System (tokens/colors.css, themes.css,
+ * typography.css, spacing.css). Reference the SEMANTIC tokens (--bg, --text,
+ * --accent, --text-accent, --radius, --space-*) in app code; the raw --bt-*
+ * palette underneath is the provenance, exposed so adapters (e.g. VitePress)
+ * can remap freely.
+ *
+ * Dark is the canonical default. The light scheme overrides the semantic
+ * tokens; it activates on `:root:not(.dark)` (VitePress's appearance system)
+ * as well as an explicit `.light` / `[data-theme="light"]`.
+ *
+ * Fills vs text: keep --accent / --green for FILLS (buttons, glow, washes);
+ * use --text-accent / --text-green for COLORED TEXT and icons — light mode
+ * darkens those to deep beetroot so links/labels pass WCAG-AA on white.
  */
 :root {
   /* ── Brand palette (raw beetroot) ─────────────────────────────── */
-  --bt-pink:        #E0589A;   /* beetroot flesh — primary accent      */
-  --bt-pink-soft:   #EE9CC4;   /* highlight veins                      */
-  --bt-magenta:     #CE3D80;   /* mid root                             */
-  --bt-deep:        #8E1A52;   /* dark root                            */
-  --bt-deep-2:      #7A1646;   /* root tail                            */
-  --bt-leaf:        #3DAE62;   /* center leaf                          */
-  --bt-leaf-dark:   #2C8B4E;   /* side leaves                          */
-  --bt-green:       #46B86C;   /* "success" green (checks)             */
-  --bt-cream:       #F5EFF3;   /* near-white text                      */
-  --bt-ink:         #1a0c14;   /* near-black, for text on accent       */
-
-  /* ── Surfaces ─────────────────────────────────────────────────── */
-  --bg:             #15101c;
-  --bg-grad:        #1b1326;   /* radial hero glow inner stop          */
-  --card:           #1d1726;
-  --card-soft:      #241c31;
+  --bt-pink:      #E0589A;   /* beetroot flesh — primary accent */
+  --bt-pink-soft: #EE9CC4;   /* highlight veins */
+  --bt-magenta:   #CE3D80;   /* mid root */
+  --bt-deep:      #8E1A52;   /* dark root */
+  --bt-deep-2:    #7A1646;   /* root tail */
+  --bt-leaf:      #3DAE62;   /* center leaf */
+  --bt-leaf-dark: #2C8B4E;   /* side leaves */
+  --bt-green:     #46B86C;   /* "success" green (checks) */
+  --bt-cream:     #F5EFF3;   /* near-white text */
+  --bt-ink:       #1a0c14;   /* near-black, for text on accent */
+
+  /* ── Surfaces (dark scheme — the canonical btravstack look) ───── */
+  --bg:        #15101c;
+  --bg-grad:   #1b1326;   /* radial hero glow inner stop */
+  --card:      #1d1726;
+  --card-soft: #241c31;
 
   /* ── Borders / dividers ──────────────────────────────────────── */
-  --border:         rgba(255, 255, 255, 0.08);
-  --border-2:       rgba(255, 255, 255, 0.12);
+  --border:   rgba(255, 255, 255, 0.08);
+  --border-2: rgba(255, 255, 255, 0.12);
 
   /* ── Text ────────────────────────────────────────────────────── */
-  --text:           #F5EFF3;
-  --muted:          #AEA1BC;
-  --faint:          #7E7290;
-
-  /* ── Accent (semantic alias of the brand pink) ───────────────── */
-  --accent:         #E0589A;
-  --accent-deep:    #8E1A52;
-  --accent-contrast:#1a0c14;   /* readable text on an accent fill      */
-  --accent-rgb:     224, 88, 154; /* for rgba(var(--accent-rgb), .3)   */
-  --green:          #46B86C;
-
-  /* ── Typography ──────────────────────────────────────────────── */
+  --text:  #F5EFF3;
+  --muted: #AEA1BC;
+  --faint: #7E7290;
+
+  /* ── Accent (brand FILL) ─────────────────────────────────────── */
+  --accent:          #E0589A;
+  --accent-deep:     #8E1A52;
+  --accent-contrast: #1a0c14;   /* readable text on an accent fill */
+  --accent-rgb:      224, 88, 154;
+  --green:           #46B86C;
+  --green-rgb:       70, 184, 108;
+
+  /* ── Accent-as-TEXT (split from fill; light darkens these for AA) ─ */
+  --text-accent: #E0589A;
+  --text-green:  #46B86C;
+
+  /* ── Glass (frosted sticky headers) ──────────────────────────── */
+  --glass: rgba(21, 16, 28, 0.66);
+
+  /* ── Accent washes / lines / code inset ──────────────────────── */
+  --accent-wash:   rgba(224, 88, 154, 0.10);
+  --accent-wash-2: rgba(224, 88, 154, 0.16);
+  --accent-line:   rgba(224, 88, 154, 0.25);
+  --code-bg:       rgba(0, 0, 0, 0.35);   /* inline code inset */
+
+  /* ── Typography: families ────────────────────────────────────── */
   --sans: 'Montserrat', 'Segoe UI', system-ui, sans-serif;
   --mono: 'JetBrains Mono', ui-monospace, 'SF Mono', Menlo, monospace;
-  --fw-medium:   500;
-  --fw-semibold: 600;
-  --fw-bold:     700;
-  --fw-extrabold:800;
+
+  /* ── Typography: weights ─────────────────────────────────────── */
+  --fw-medium:    500;
+  --fw-semibold:  600;
+  --fw-bold:      700;
+  --fw-extrabold: 800;
+
+  /* ── Typography: display / heading scale (clamped, fluid) ─────── */
+  --fs-hero: clamp(52px, 9vw, 92px);
+  --fs-h1:   clamp(34px, 6vw, 56px);
+  --fs-h2:   clamp(28px, 4vw, 40px);
+  --fs-h3:   23px;
+  --fs-h4:   18px;
+
+  /* ── Typography: body / UI scale ─────────────────────────────── */
+  --fs-lead:    clamp(20px, 2.6vw, 26px);
+  --fs-body-lg: 17px;
+  --fs-body:    15px;
+  --fs-body-sm: 14px;
+  --fs-caption: 13px;
+  --fs-eyebrow: 13px;
+
+  /* ── Typography: tracking + line heights ─────────────────────── */
+  --tracking-hero:    -2.5px;
+  --tracking-tight:   -1px;
+  --tracking-snug:    -0.5px;
+  --tracking-eyebrow: 1.5px;
+  --lh-tight: 1.08;
+  --lh-snug:  1.3;
+  --lh-body:  1.6;
 
   /* ── Radii ───────────────────────────────────────────────────── */
   --radius-sm:   9px;
@@ -60,22 +107,56 @@
   --radius-pill: 999px;
 
   /* ── Spacing scale ───────────────────────────────────────────── */
-  --space-1:  6px;
-  --space-2:  9px;
-  --space-3:  14px;
-  --space-4:  18px;
-  --space-5:  22px;
-  --space-6:  28px;
+  --space-1: 6px;
+  --space-2: 9px;
+  --space-3: 14px;
+  --space-4: 18px;
+  --space-5: 22px;
+  --space-6: 28px;
 
   /* ── Shadows ─────────────────────────────────────────────────── */
   --shadow-card:   0 24px 60px -28px rgba(0, 0, 0, 0.8);
   --shadow-accent: 0 12px 30px -10px rgba(224, 88, 154, 0.6);
   --shadow-toast:  0 18px 40px -16px rgba(0, 0, 0, 0.8);
 
-  /* ── Layout ──────────────────────────────────────────────────── */
-  --container: 1180px;
-
-  /* ── Motion ──────────────────────────────────────────────────── */
+  /* ── Layout & motion ─────────────────────────────────────────── */
+  --container:  1180px;
   --speed-fast: 0.15s;
   --speed:      0.2s;
+  --ease:       ease;
+}
+
+/*
+ * Light scheme — warm, faintly beetroot-tinted near-whites. Only the semantic
+ * tokens flip; the raw --bt-* palette is unchanged. Brand FILLS stay vibrant
+ * pink (dark ink on top); accent-as-TEXT darkens to deep beetroot for AA.
+ */
+:root:not(.dark),
+[data-theme="light"],
+.light {
+  --bg:        #FBF7F9;
+  --bg-grad:   #FCEDF4;
+  --card:      #FFFFFF;
+  --card-soft: #F6EDF2;
+
+  --border:   rgba(26, 12, 20, 0.10);
+  --border-2: rgba(26, 12, 20, 0.17);
+
+  --text:  #1F0E18;
+  --muted: #6A5965;
+  --faint: #978996;
+
+  --accent:      #E0589A;   /* fill unchanged (dark ink on top) */
+  --text-accent: #A52260;   /* ~5.6:1 on white — links, eyebrows, wordmark */
+  --text-green:  #15683A;   /* ~5.2:1 on white — affirmative text */
+
+  --accent-wash:   rgba(224, 88, 154, 0.12);
+  --accent-wash-2: rgba(224, 88, 154, 0.16);
+  --accent-line:   rgba(142, 26, 82, 0.22);
+  --glass:         rgba(255, 255, 255, 0.72);
+  --code-bg:       #F4EAF0;
+
+  --shadow-card:   0 18px 44px -26px rgba(142, 26, 82, 0.30);
+  --shadow-accent: 0 12px 26px -10px rgba(224, 88, 154, 0.45);
+  --shadow-toast:  0 18px 40px -16px rgba(40, 16, 30, 0.18);
 }