Skip to content

Your Android phone and your Windows PC, working as one. Local-first, end-to-end encrypted, no account.

Add design tokens and core screen mockups

Bee3bdcb5be5014
diff --git a/docs/design/README.md b/docs/design/README.md
index 961bd14..5498cdf 100644
--- a/docs/design/README.md
+++ b/docs/design/README.md
@@ -1,6 +1,15 @@
# Design
-Preview: open `themes/index.html` in a browser (switch themes and Material You seeds at the top).
+Contents:
+
+| Path | What it is |
+|---|---|
+| `tokens.json` | Single source of truth for colors (per theme and seed), type, spacing, shapes, elevation and motion. QML and Compose themes are generated from it |
+| `themes/index.html` | Theme overview: Home screens, color roles, typography, components |
+| `mockups/index.html` | Core flows: pairing, phone setup, Choose your power, notifications, messages, mirroring and app windows, Deck, Power settings |
+| `assets/` | Shared preview stylesheet and helpers used by the mockups |
+
+Open the HTML files in a browser and switch themes and Material You seeds at the top.
## Decision (2026-10-05)
diff --git a/docs/design/assets/nl.css b/docs/design/assets/nl.css
new file mode 100644
index 0000000..0f2c85e
--- /dev/null
+++ b/docs/design/assets/nl.css
@@ -0,0 +1,172 @@
+/* Nectarlink design preview stylesheet. Mirrors docs/design/tokens.json. */
+:root{
+ --sans:"Figtree","Segoe UI Variable Text","Segoe UI",system-ui,sans-serif;
+ --serif:"Instrument Serif",Georgia,serif;
+ --mono:"Space Mono","Cascadia Mono",Consolas,monospace;
+ --hand:"Caveat","Segoe Print",cursive;
+}
+*{box-sizing:border-box;margin:0;padding:0}
+body{font-family:var(--sans);background:var(--page);color:var(--on-surface);-webkit-font-smoothing:antialiased;transition:background .4s,color .4s}
+svg{width:19px;height:19px;stroke:currentColor;fill:none;stroke-width:1.8;stroke-linecap:round;stroke-linejoin:round;flex:none}
+
+/* ---------- theme tokens ---------- */
+[data-theme^="bloom"]{
+ --page:var(--surface-low);
+ --display:var(--sans);--display-weight:650;--display-track:-.02em;
+ --label:var(--sans);--label-case:none;--label-track:0;--label-size:12.5px;--label-weight:600;
+ --r-xl:28px;--r-lg:20px;--r-md:16px;--r-sm:12px;--r-xs:8px;--r-pill:999px;
+ --card-bg:var(--surface-container);--card-border:transparent;
+ --tile-bg:var(--surface-container-high);
+ --hero-bg:color-mix(in srgb,var(--primary-container) 62%,var(--surface));--hero-ink:var(--on-primary-container);
+ --btn-bg:var(--primary);--btn-ink:var(--on-primary);--btn-shadow:none;
+ --rail-bg:var(--surface-low);--indicator:var(--secondary-container);--on-indicator:var(--on-secondary-container);
+ --win-bg:var(--surface);--win-border:var(--outline-variant);
+ --win-shadow:0 1px 2px rgba(0,0,0,.06),0 24px 60px -20px rgba(0,0,0,.18);
+ --texture:none;--grid:none;--ok:#2E7D4F;--warn:#9A6700;
+}
+[data-theme="bloom-dark"]{--ok:#7BD8A0;--warn:#F2C14E}
+[data-theme^="graphite"]{
+ --display:var(--serif);--display-weight:400;--display-track:-.01em;
+ --label:var(--mono);--label-case:uppercase;--label-track:.12em;--label-size:10.5px;--label-weight:400;
+ --r-xl:6px;--r-lg:4px;--r-md:4px;--r-sm:3px;--r-xs:2px;--r-pill:3px;
+ --card-bg:transparent;--tile-bg:transparent;--hero-bg:transparent;--rail-bg:transparent;
+ --win-shadow:0 30px 70px -30px rgba(0,0,0,.35);
+}
+[data-theme="graphite-paper"]{
+ --page:#ECE8DF;
+ --surface:#F5F2EB;--surface-low:#F1EDE4;--surface-container:#F5F2EB;--surface-container-high:#EFEBE2;--surface-container-highest:#E8E3D7;
+ --on-surface:#1A1918;--on-surface-variant:#5E5A54;--outline:#4A4743;--outline-variant:#D5CFC2;
+ --primary:#1A1918;--on-primary:#F5F2EB;--primary-container:#E8E3D7;--on-primary-container:#1A1918;
+ --secondary-container:#E8E3D7;--on-secondary-container:#1A1918;
+ --card-border:#D5CFC2;--hero-ink:#1A1918;--btn-bg:#1A1918;--btn-ink:#F5F2EB;--btn-shadow:3px 3px 0 #D5CFC2;
+ --indicator:#1A1918;--on-indicator:#F5F2EB;--win-bg:#F5F2EB;--win-border:#CFC8BA;--ok:#3F6B4A;--warn:#8A6A1F;
+ --texture:url("data:image/svg+xml,%3Csvg viewBox='0 0 240 240' xmlns='http://www.w3.org/2000/svg'%3E%3Cfilter id='n'%3E%3CfeTurbulence type='fractalNoise' baseFrequency='.9' numOctaves='3' stitchTiles='stitch'/%3E%3C/filter%3E%3Crect width='100%25' height='100%25' filter='url(%23n)' opacity='.22'/%3E%3C/svg%3E");
+ --grid:linear-gradient(rgba(74,71,67,.06) 1px,transparent 1px),linear-gradient(90deg,rgba(74,71,67,.06) 1px,transparent 1px);
+}
+[data-theme="graphite-slate"]{
+ --page:#070708;
+ --surface:#0D0D0E;--surface-low:#0B0B0C;--surface-container:#0D0D0E;--surface-container-high:#141416;--surface-container-highest:#1A1A1D;
+ --on-surface:#E8EAED;--on-surface-variant:#9A9CA1;--outline:#7E8084;--outline-variant:#26272A;
+ --primary:#E8EAED;--on-primary:#0D0D0E;--primary-container:#1A1A1D;--on-primary-container:#E8EAED;
+ --secondary-container:#1A1A1D;--on-secondary-container:#E8EAED;
+ --card-border:#26272A;--hero-ink:#E8EAED;--btn-bg:#E8EAED;--btn-ink:#0D0D0E;--btn-shadow:3px 3px 0 #26272A;
+ --indicator:#E8EAED;--on-indicator:#0D0D0E;--win-bg:#0D0D0E;--win-border:#232427;--ok:#8FC7A0;--warn:#E2C47A;
+ --texture:url("data:image/svg+xml,%3Csvg viewBox='0 0 240 240' xmlns='http://www.w3.org/2000/svg'%3E%3Cfilter id='n'%3E%3CfeTurbulence type='fractalNoise' baseFrequency='.9' numOctaves='3' stitchTiles='stitch'/%3E%3C/filter%3E%3Crect width='100%25' height='100%25' filter='url(%23n)' opacity='.12'/%3E%3C/svg%3E");
+ --grid:linear-gradient(rgba(200,208,216,.035) 1px,transparent 1px),linear-gradient(90deg,rgba(200,208,216,.035) 1px,transparent 1px);
+}
+.G{display:none}[data-theme^="graphite"] .G{display:revert}
+[data-theme^="graphite"] .B{display:none}
+
+/* ---------- page chrome ---------- */
+.bar{position:sticky;top:0;z-index:20;display:flex;align-items:center;gap:16px;flex-wrap:wrap;padding:12px 28px;
+ background:color-mix(in srgb,var(--page) 85%,transparent);backdrop-filter:blur(14px);border-bottom:1px solid var(--outline-variant)}
+.brand{font-weight:700;font-size:16px;letter-spacing:-.01em;margin-right:auto}
+.brand span{font-weight:500;color:var(--on-surface-variant)}
+.seg{display:flex;padding:3px;border-radius:999px;background:var(--surface-container-high);gap:2px}
+.seg button{border:0;background:none;font:600 13px var(--sans);color:var(--on-surface-variant);padding:7px 13px;border-radius:999px;cursor:pointer}
+.seg button.on{background:var(--surface);color:var(--on-surface);box-shadow:0 1px 3px rgba(0,0,0,.12)}
+.seeds{display:flex;gap:7px;align-items:center;font-size:12.5px;color:var(--on-surface-variant)}
+.seeds button{width:24px;height:24px;border-radius:50%;border:0;cursor:pointer;outline:2px solid transparent;outline-offset:2px}
+.seeds button.on{outline-color:var(--on-surface)}
+.seeds.off{opacity:.3;pointer-events:none}
+.toc{max-width:1280px;margin:36px auto 0;padding:0 28px}
+.toc h1{font-family:var(--display);font-weight:var(--display-weight);font-size:40px;letter-spacing:var(--display-track)}
+.toc p{color:var(--on-surface-variant);margin-top:8px;font-size:15px;line-height:1.55;max-width:760px}
+.toc nav{display:flex;gap:8px;flex-wrap:wrap;margin-top:18px}
+.toc a{font-size:13px;color:var(--on-surface);text-decoration:none;padding:7px 12px;border-radius:var(--r-pill);background:var(--surface-container-high)}
+section.screen-set{max-width:1280px;margin:0 auto;padding:56px 28px 8px}
+.set-head{margin-bottom:22px}
+.kicker,.lbl,.cap{font-family:var(--label);text-transform:var(--label-case);letter-spacing:var(--label-track);font-size:var(--label-size);font-weight:var(--label-weight);color:var(--on-surface-variant)}
+.set-head h2{font-family:var(--display);font-weight:var(--display-weight);font-size:28px;letter-spacing:var(--display-track);margin-top:6px}
+.set-head p{color:var(--on-surface-variant);font-size:14px;line-height:1.55;margin-top:6px;max-width:820px}
+.row{display:flex;gap:32px;flex-wrap:wrap;align-items:flex-start}
+
+/* ---------- desktop window ---------- */
+.win{width:940px;max-width:100%;height:600px;display:flex;border-radius:var(--r-xl);overflow:hidden;position:relative;background:var(--win-bg);color:var(--on-surface);border:1px solid var(--win-border);box-shadow:var(--win-shadow)}
+.win.sm{width:520px;height:600px}
+.win::before,.scr::before{content:"";position:absolute;inset:0;pointer-events:none;background-image:var(--texture),var(--grid);background-size:240px 240px,32px 32px,32px 32px;mix-blend-mode:multiply;z-index:0}
+[data-theme="graphite-slate"] .win::before,[data-theme="graphite-slate"] .scr::before{mix-blend-mode:screen}
+.win>*,.scr>*{position:relative;z-index:1}
+.rail{width:80px;display:flex;flex-direction:column;align-items:center;gap:4px;padding:16px 0;background:var(--rail-bg);border-right:1px solid var(--outline-variant);flex:none}
+.mark{width:38px;height:38px;border-radius:var(--r-sm);display:grid;place-items:center;background:var(--primary);color:var(--on-primary);margin-bottom:14px}
+.nav{display:flex;flex-direction:column;align-items:center;gap:4px;font-size:11px;font-weight:600;color:var(--on-surface-variant);padding:4px 0}
+.nav i{width:52px;height:30px;border-radius:var(--r-pill);display:grid;place-items:center}
+.nav.on{color:var(--on-surface)}.nav.on i{background:var(--indicator);color:var(--on-indicator)}
+[data-theme^="graphite"] .nav{font-family:var(--mono);font-size:9px;letter-spacing:.1em;text-transform:uppercase;font-weight:400}
+.spacer{flex:1}
+.main{flex:1;display:flex;flex-direction:column;min-width:0}
+.top{height:52px;display:flex;align-items:center;gap:12px;padding:0 22px;border-bottom:1px solid var(--outline-variant);flex:none}
+.top h3{font-family:var(--display);font-weight:var(--display-weight);font-size:20px;letter-spacing:var(--display-track)}
+.status{display:flex;align-items:center;gap:8px;font-size:12.5px;color:var(--on-surface-variant)}
+.dot{width:7px;height:7px;border-radius:50%;background:var(--ok);box-shadow:0 0 0 3px color-mix(in srgb,var(--ok) 22%,transparent)}
+[data-theme^="graphite"] .status{font-family:var(--mono);font-size:10.5px;letter-spacing:.1em;text-transform:uppercase}
+.fill{flex:1}
+.body{flex:1;min-height:0;display:flex}
+.pane{padding:18px 22px;overflow:hidden}
+
+/* ---------- components ---------- */
+.card{background:var(--card-bg);border:1px solid var(--card-border);border-radius:var(--r-lg);padding:16px}
+.btn{height:40px;padding:0 18px;border-radius:var(--r-pill);font:600 13.5px var(--sans);display:inline-flex;align-items:center;justify-content:center;gap:8px;border:0;white-space:nowrap}
+.btn.fill{background:var(--btn-bg);color:var(--btn-ink);box-shadow:var(--btn-shadow)}
+.btn.tonal{background:var(--secondary-container);color:var(--on-secondary-container)}
+.btn.out{background:transparent;color:var(--on-surface);border:1px solid var(--outline)}
+.btn.text{background:none;color:var(--primary);padding:0 10px}
+.btn.sm{height:32px;padding:0 13px;font-size:12.5px}
+.btn.wide{width:100%}
+[data-theme^="graphite"] .btn{font-family:var(--mono);font-weight:400;font-size:11px;letter-spacing:.12em;text-transform:uppercase}
+[data-theme^="graphite"] .btn.text{color:var(--on-surface);text-decoration:underline;text-underline-offset:3px}
+.chip{display:inline-flex;align-items:center;gap:6px;height:30px;padding:0 12px;border-radius:var(--r-pill);background:var(--surface-container-high);font-size:12.5px;font-weight:600;color:var(--on-surface)}
+.chip.on{background:var(--secondary-container);color:var(--on-secondary-container)}
+[data-theme^="graphite"] .chip{background:transparent;border:1px solid var(--outline-variant);font-family:var(--mono);font-weight:400;font-size:10px;letter-spacing:.08em;text-transform:uppercase}
+[data-theme^="graphite"] .chip.on{border-color:var(--on-surface);background:var(--on-surface);color:var(--surface)}
+.av{width:36px;height:36px;border-radius:50%;display:grid;place-items:center;font-size:13px;font-weight:700;flex:none;background:var(--surface-container-highest);color:var(--on-surface-variant)}
+.av.p{background:var(--primary-container);color:var(--on-primary-container)}
+[data-theme^="graphite"] .av{border-radius:4px;border:1px solid var(--outline-variant);background:transparent;font-family:var(--mono);font-weight:400}
+.lock{display:inline-flex;align-items:center;gap:5px;font-size:11px;font-weight:600;color:var(--on-surface-variant);height:22px;padding:0 8px;border-radius:var(--r-pill);border:1px solid var(--outline-variant)}
+.lock svg{width:13px;height:13px}
+[data-theme^="graphite"] .lock{font-family:var(--mono);font-weight:400;letter-spacing:.06em;text-transform:uppercase;font-size:9.5px}
+.switch{width:46px;height:28px;border-radius:999px;background:var(--surface-container-highest);position:relative;flex:none;border:1.5px solid var(--outline)}
+.switch::after{content:"";position:absolute;left:5px;top:5px;width:15px;height:15px;border-radius:50%;background:var(--outline)}
+.switch.on{background:var(--primary);border-color:var(--primary)}
+.switch.on::after{left:auto;right:3px;top:3px;width:19px;height:19px;background:var(--on-primary)}
+[data-theme^="graphite"] .switch,[data-theme^="graphite"] .switch::after{border-radius:3px}
+.code{display:inline-flex;align-items:center;gap:10px;height:32px;padding:0 6px 0 12px;border-radius:var(--r-pill);background:var(--primary-container);color:var(--on-primary-container);font-size:12.5px;font-weight:600}
+.code b{font-family:var(--mono);letter-spacing:.14em;font-size:13px}
+.code em{font-style:normal;height:24px;padding:0 10px;border-radius:var(--r-pill);background:var(--btn-bg);color:var(--btn-ink);display:grid;place-items:center;font-size:11.5px}
+[data-theme^="graphite"] .code{background:transparent;border:1px dashed var(--outline)}
+.list .it{display:flex;gap:12px;align-items:center;padding:11px 12px;border-radius:var(--r-md)}
+.list .it.on{background:var(--secondary-container);color:var(--on-secondary-container)}
+[data-theme^="graphite"] .list .it{border-radius:0;border-bottom:1px solid var(--outline-variant)}
+[data-theme^="graphite"] .list .it.on{background:transparent;box-shadow:inset 3px 0 0 var(--on-surface)}
+.it h5{font-size:13.5px;font-weight:650;display:flex;justify-content:space-between;gap:8px}
+.it h5 span{font-weight:400;font-size:11.5px;color:var(--on-surface-variant)}
+.it p{font-size:12.5px;color:var(--on-surface-variant);margin-top:2px;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
+.it .tx{min-width:0;flex:1}
+.badge{min-width:20px;height:20px;border-radius:10px;background:var(--primary);color:var(--on-primary);font-size:11px;font-weight:700;display:grid;place-items:center;padding:0 6px}
+[data-theme^="graphite"] .badge{border-radius:2px;font-family:var(--mono);font-weight:400}
+.hint{font-size:12px;color:var(--on-surface-variant);line-height:1.45}
+.note{font-family:var(--hand);font-size:19px;color:var(--on-surface-variant);transform:rotate(-4deg);display:inline-block}
+.crop{position:relative;padding:10px}
+.crop i{position:absolute;width:12px;height:12px;border:0 solid var(--on-surface-variant);display:none}
+[data-theme^="graphite"] .crop i{display:block}
+.crop i:nth-child(1){top:0;left:0;border-top-width:1px;border-left-width:1px}
+.crop i:nth-child(2){top:0;right:0;border-top-width:1px;border-right-width:1px}
+.crop i:nth-child(3){bottom:0;left:0;border-bottom-width:1px;border-left-width:1px}
+.crop i:nth-child(4){bottom:0;right:0;border-bottom-width:1px;border-right-width:1px}
+
+/* ---------- phone ---------- */
+.phone{width:304px;height:640px;padding:9px;border-radius:46px;background:#141312;box-shadow:var(--win-shadow);flex:none}
+[data-theme="graphite-slate"] .phone{background:#2a2b2e}
+.scr{position:relative;width:100%;height:100%;border-radius:38px;overflow:hidden;background:var(--surface);color:var(--on-surface);display:flex;flex-direction:column;gap:12px;padding:46px 16px 14px}
+.scr>*{flex-shrink:0}
+.scr>.cam{position:absolute;top:13px;left:50%;width:84px;height:23px;border-radius:20px;background:#000;transform:translateX(-50%);z-index:3}
+.scr>.sb{position:absolute;top:14px;left:28px;right:28px;display:flex;justify-content:space-between;font-size:12px;font-weight:600;z-index:2}
+.ph-title{font-family:var(--display);font-weight:var(--display-weight);font-size:26px;letter-spacing:var(--display-track);line-height:1.1}
+.ph-sub{font-size:13px;color:var(--on-surface-variant);line-height:1.5}
+.tabbar{margin-top:auto;display:flex;justify-content:space-around;padding:10px 6px;border-radius:var(--r-xl);background:var(--surface-container)}
+[data-theme^="graphite"] .tabbar{background:transparent;border-top:1px solid var(--outline-variant);border-radius:0}
+.tabbar span{width:58px;height:32px;border-radius:var(--r-pill);display:grid;place-items:center;color:var(--on-surface-variant)}
+.tabbar span.on{background:var(--indicator);color:var(--on-indicator)}
+.caption{margin-top:12px;font-size:12.5px;color:var(--on-surface-variant);max-width:304px;line-height:1.5}
+.caption b{color:var(--on-surface);font-weight:650}
+@media (prefers-reduced-motion:reduce){*{transition:none!important}}
diff --git a/docs/design/assets/nl.js b/docs/design/assets/nl.js
new file mode 100644
index 0000000..54c9a8e
--- /dev/null
+++ b/docs/design/assets/nl.js
@@ -0,0 +1,73 @@
+// Nectarlink design preview helpers: icons, Material You seeds, theme switcher.
+const ICON = {
+ home:'<path d="M3 11l9-7 9 7"/><path d="M5 10v10h14V10"/>',
+ msg:'<path d="M21 12a8 8 0 0 1-11.6 7.1L4 20l1-4.6A8 8 0 1 1 21 12z"/>',
+ bell:'<path d="M6 8a6 6 0 1 1 12 0c0 7 3 8 3 8H3s3-1 3-8"/><path d="M10 20a2 2 0 0 0 4 0"/>',
+ photo:'<rect x="3" y="3" width="18" height="18" rx="3"/><circle cx="9" cy="9" r="2"/><path d="M21 15l-5-5L5 21"/>',
+ apps:'<rect x="4" y="4" width="6" height="6" rx="1.5"/><rect x="14" y="4" width="6" height="6" rx="1.5"/><rect x="4" y="14" width="6" height="6" rx="1.5"/><rect x="14" y="14" width="6" height="6" rx="1.5"/>',
+ deck:'<rect x="3" y="5" width="18" height="14" rx="3"/><path d="M8 10h.01M12 10h.01M16 10h.01M8 14h8"/>',
+ gear:'<circle cx="12" cy="12" r="3"/><path d="M12 2v3M12 19v3M4.9 4.9l2.1 2.1M17 17l2.1 2.1M2 12h3M19 12h3M4.9 19.1L7 17M17 7l2.1-2.1"/>',
+ clip:'<rect x="8" y="3" width="8" height="4" rx="1"/><path d="M16 5h2a2 2 0 0 1 2 2v12a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2V7a2 2 0 0 1 2-2h2"/>',
+ mirror:'<rect x="2" y="4" width="14" height="10" rx="2"/><rect x="17" y="8" width="5" height="10" rx="1.5"/><path d="M6 18h6"/>',
+ send:'<path d="M22 2L11 13M22 2l-7 20-4-9-9-4z"/>',
+ ring:'<path d="M6 8a6 6 0 1 1 12 0c0 7 3 8 3 8H3s3-1 3-8"/><path d="M10 20a2 2 0 0 0 4 0"/>',
+ search:'<circle cx="11" cy="11" r="7"/><path d="M20 20l-3.5-3.5"/>',
+ play:'<path d="M8 5l11 7-11 7z"/>', pause:'<path d="M8 5v14M16 5v14"/>',
+ prev:'<path d="M19 20L9 12l10-8zM5 19V5"/>', next:'<path d="M5 4l10 8-10 8zM19 5v14"/>',
+ check:'<path d="M5 12.5l4.5 4.5L19 7.5"/>', x:'<path d="M6 6l12 12M18 6L6 18"/>',
+ chev:'<path d="M9 6l6 6-6 6"/>', back:'<path d="M15 6l-6 6 6 6"/>',
+ lock:'<rect x="5" y="11" width="14" height="10" rx="2"/><path d="M8 11V8a4 4 0 0 1 8 0v3"/>',
+ hex:'<path d="M12 2.5l8.2 4.75v9.5L12 21.5l-8.2-4.75v-9.5z"/><path d="M9 12h6"/>',
+ shield:'<path d="M12 3l8 3v6c0 5-3.5 8-8 9-4.5-1-8-4-8-9V6z"/>',
+ bolt:'<path d="M13 2L4 14h7l-1 8 9-12h-7z"/>', usb:'<path d="M12 2v16M8 6l4-4 4 4M7 12v2a5 5 0 0 0 10 0v-2"/>',
+ wifi:'<path d="M5 12.5a10 10 0 0 1 14 0M8.5 16a5 5 0 0 1 7 0M2 9a15 15 0 0 1 20 0"/>',
+ qr:'<rect x="3" y="3" width="7" height="7" rx="1"/><rect x="14" y="3" width="7" height="7" rx="1"/><rect x="3" y="14" width="7" height="7" rx="1"/><path d="M14 14h3v3M21 14v7h-7"/>',
+ attach:'<path d="M21 11l-8.5 8.5a5 5 0 0 1-7-7L14 4a3.5 3.5 0 0 1 5 5l-8.5 8.5a2 2 0 0 1-3-3L15 7"/>',
+ emoji:'<circle cx="12" cy="12" r="9"/><path d="M8.5 14.5a4.5 4.5 0 0 0 7 0M9 9.5h.01M15 9.5h.01"/>',
+ vol:'<path d="M4 9v6h4l5 4V5L8 9z"/><path d="M17 9a4 4 0 0 1 0 6"/>',
+ rotate:'<path d="M20 11a8 8 0 1 0-2.3 5.7M20 5v6h-6"/>', camera:'<path d="M3 7h4l2-2h6l2 2h4v12H3z"/><circle cx="12" cy="13" r="3.5"/>',
+ kb:'<rect x="2" y="6" width="20" height="12" rx="2"/><path d="M6 10h.01M10 10h.01M14 10h.01M18 10h.01M7 14h10"/>',
+ screen:'<rect x="3" y="4" width="18" height="12" rx="2"/><path d="M8 20h8M12 16v4"/>',
+ mic:'<rect x="9" y="2" width="6" height="12" rx="3"/><path d="M5 11a7 7 0 0 0 14 0M12 18v4"/>',
+ obs:'<circle cx="12" cy="12" r="9"/><circle cx="12" cy="12" r="3"/>', moon:'<path d="M20 14.5A8 8 0 0 1 9.5 4a8 8 0 1 0 10.5 10.5z"/>',
+ code:'<path d="M8 8l-5 4 5 4M16 8l5 4-5 4"/>', folder:'<path d="M3 7a2 2 0 0 1 2-2h4l2 2h8a2 2 0 0 1 2 2v8a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2z"/>',
+ more:'<circle cx="5" cy="12" r="1"/><circle cx="12" cy="12" r="1"/><circle cx="19" cy="12" r="1"/>',
+ plus:'<path d="M12 5v14M5 12h14"/>', handset:'<rect x="7" y="2" width="10" height="20" rx="2.5"/><path d="M11 18h2"/>', filter:'<path d="M4 5h16l-6 8v6l-4-2v-4z"/>'
+};
+const i = n => `<svg viewBox="0 0 24 24">${ICON[n]}</svg>`;
+
+const SEEDS = {
+ honey:{light:{primary:'#8A5100','on-primary':'#FFFFFF','primary-container':'#FFDDB8','on-primary-container':'#2C1600','secondary-container':'#F3E0CB','on-secondary-container':'#261A0C',surface:'#FFF8F3','surface-low':'#FBF2EB','surface-container':'#F5ECE4','surface-container-high':'#EFE6DE','surface-container-highest':'#E9E1D9','on-surface':'#1F1B16','on-surface-variant':'#51453A',outline:'#837468','outline-variant':'#D5C3B5'},
+ dark:{primary:'#FFB95F','on-primary':'#4A2800','primary-container':'#693C00','on-primary-container':'#FFDDB8','secondary-container':'#574330','on-secondary-container':'#F3E0CB',surface:'#17130E','surface-low':'#120E0A','surface-container':'#241F1A','surface-container-high':'#2E2924','surface-container-highest':'#39342E','on-surface':'#EBE1D9','on-surface-variant':'#D5C3B5',outline:'#9E8E81','outline-variant':'#51453A'}},
+ sage:{light:{primary:'#3B6939','on-primary':'#FFFFFF','primary-container':'#BCF0B4','on-primary-container':'#002204','secondary-container':'#D6E8CF','on-secondary-container':'#111F0F',surface:'#F7FBF1','surface-low':'#F1F5EB','surface-container':'#EBEFE5','surface-container-high':'#E6E9E0','surface-container-highest':'#E0E4DA','on-surface':'#191D17','on-surface-variant':'#424940',outline:'#72796F','outline-variant':'#C2C8BD'},
+ dark:{primary:'#A1D39A','on-primary':'#0A390F','primary-container':'#234F24','on-primary-container':'#BCF0B4','secondary-container':'#3B4B38','on-secondary-container':'#D6E8CF',surface:'#10140F','surface-low':'#0C100B','surface-container':'#1D211B','surface-container-high':'#272B25','surface-container-highest':'#32362F','on-surface':'#E0E4DA','on-surface-variant':'#C2C8BD',outline:'#8C9388','outline-variant':'#424940'}},
+ lavender:{light:{primary:'#65558F','on-primary':'#FFFFFF','primary-container':'#E9DDFF','on-primary-container':'#201047','secondary-container':'#E8DEF8','on-secondary-container':'#1D192B',surface:'#FDF7FF','surface-low':'#F7F2FA','surface-container':'#F2ECF4','surface-container-high':'#ECE6EE','surface-container-highest':'#E6E0E9','on-surface':'#1D1B20','on-surface-variant':'#49454E',outline:'#7A757F','outline-variant':'#CAC4CF'},
+ dark:{primary:'#CFBDFE','on-primary':'#36275D','primary-container':'#4D3D75','on-primary-container':'#E9DDFF','secondary-container':'#4A4458','on-secondary-container':'#E8DEF8',surface:'#141218','surface-low':'#0F0D13','surface-container':'#211F24','surface-container-high':'#2B292F','surface-container-highest':'#36343A','on-surface':'#E6E0E9','on-surface-variant':'#CAC4CF',outline:'#948F99','outline-variant':'#49454E'}},
+ ocean:{light:{primary:'#2F628C','on-primary':'#FFFFFF','primary-container':'#CEE5FF','on-primary-container':'#001D33','secondary-container':'#D5E4F7','on-secondary-container':'#0E1D2A',surface:'#F7F9FF','surface-low':'#F1F4FA','surface-container':'#ECEEF4','surface-container-high':'#E6E8EE','surface-container-highest':'#E0E2E8','on-surface':'#181C20','on-surface-variant':'#42474E',outline:'#72777F','outline-variant':'#C2C7CF'},
+ dark:{primary:'#9BCBFB','on-primary':'#003354','primary-container':'#0F4A73','on-primary-container':'#CEE5FF','secondary-container':'#3B4858','on-secondary-container':'#D5E4F7',surface:'#101418','surface-low':'#0B0F13','surface-container':'#1C2024','surface-container-high':'#262A2F','surface-container-highest':'#31353A','on-surface':'#E0E2E8','on-surface-variant':'#C2C7CF',outline:'#8C9199','outline-variant':'#42474E'}}
+};
+
+// Deterministic fake QR code (finder patterns + pseudo-random modules). Not scannable.
+function qrSVG(size = 25, seed = 7) {
+ let s = seed, r = () => (s = (s * 9301 + 49297) % 233280) / 233280;
+ const finder = (x, y) => `<rect x="${x}" y="${y}" width="7" height="7" fill="currentColor"/><rect x="${x+1}" y="${y+1}" width="5" height="5" fill="var(--qr-bg)"/><rect x="${x+2}" y="${y+2}" width="3" height="3" fill="currentColor"/>`;
+ const inFinder = (x, y) => (x < 8 && y < 8) || (x > size - 9 && y < 8) || (x < 8 && y > size - 9);
+ let m = '';
+ for (let y = 0; y < size; y++) for (let x = 0; x < size; x++) if (!inFinder(x, y) && r() > 0.52) m += `<rect x="${x}" y="${y}" width="1" height="1"/>`;
+ return `<svg viewBox="-1 -1 ${size + 2} ${size + 2}" style="width:100%;height:100%;stroke:none;fill:currentColor">${finder(0,0)}${finder(size-7,0)}${finder(0,size-7)}${m}</svg>`;
+}
+
+function setupThemeBar() {
+ const body = document.body, themes = document.getElementById('themes'), seeds = document.getElementById('seeds');
+ let theme = 'bloom-light', seed = 'honey';
+ const apply = () => {
+ body.dataset.theme = theme; body.style.cssText = '';
+ const bloom = theme.startsWith('bloom');
+ if (bloom) { const p = SEEDS[seed][theme.endsWith('dark') ? 'dark' : 'light']; for (const k in p) body.style.setProperty('--' + k, p[k]); }
+ body.style.setProperty('--qr-bg', getComputedStyle(body).getPropertyValue('--surface'));
+ seeds.classList.toggle('off', !bloom);
+ };
+ themes.onclick = e => { const b = e.target.closest('button'); if (!b) return; theme = b.dataset.t; [...themes.children].forEach(x => x.classList.toggle('on', x === b)); apply(); };
+ seeds.onclick = e => { const b = e.target.closest('button'); if (!b) return; seed = b.dataset.s; [...seeds.querySelectorAll('button')].forEach(x => x.classList.toggle('on', x === b)); apply(); };
+ apply();
+}
diff --git a/docs/design/mockups/index.html b/docs/design/mockups/index.html
new file mode 100644
index 0000000..4e8f29c
--- /dev/null
+++ b/docs/design/mockups/index.html
@@ -0,0 +1,349 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>Nectarlink Mockups</title>
+<!-- Preview only: the apps bundle these OFL fonts locally. -->
+<link rel="preconnect" href="https://fonts.googleapis.com"><link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+<link href="https://fonts.googleapis.com/css2?family=Figtree:wght@400;500;600;700&family=Instrument+Serif&family=Space+Mono:wght@400;700&family=Caveat:wght@500&display=swap" rel="stylesheet">
+<link rel="stylesheet" href="../assets/nl.css">
+<style>
+/* --- pairing --- */
+.pair{flex:1;display:flex;flex-direction:column;align-items:center;justify-content:center;text-align:center;padding:28px 40px;gap:14px}
+.pair h2{font-family:var(--display);font-weight:var(--display-weight);font-size:28px;letter-spacing:var(--display-track)}
+.qrbox{width:200px;height:200px;padding:14px;border-radius:var(--r-lg);background:var(--surface);color:var(--on-surface);border:1px solid var(--outline-variant)}
+[data-theme^="bloom"] .qrbox{box-shadow:0 0 0 8px var(--surface-container-high)}
+.steps{display:flex;gap:18px;font-size:12.5px;color:var(--on-surface-variant)}
+.steps b{display:inline-grid;place-items:center;width:20px;height:20px;border-radius:50%;background:var(--secondary-container);color:var(--on-secondary-container);font-size:11px;margin-right:6px}
+[data-theme^="graphite"] .steps b{border-radius:2px;font-family:var(--mono);font-weight:400}
+.alt{display:flex;gap:10px}
+.timer{font-size:12px;color:var(--on-surface-variant)}
+/* camera viewfinder */
+.finder{flex:1;margin:-46px -16px 0;background:radial-gradient(120% 80% at 50% 40%,#4a5058,#15181c);position:relative;display:grid;place-items:center}
+.finder .frame{width:190px;height:190px;position:relative}
+.finder .frame i{position:absolute;width:34px;height:34px;border:3px solid #fff;border-radius:6px}
+.finder .frame i:nth-child(1){top:0;left:0;border-right:0;border-bottom:0}.finder .frame i:nth-child(2){top:0;right:0;border-left:0;border-bottom:0}
+.finder .frame i:nth-child(3){bottom:0;left:0;border-right:0;border-top:0}.finder .frame i:nth-child(4){bottom:0;right:0;border-left:0;border-top:0}
+.finder .ghost{position:absolute;inset:22px;color:rgba(255,255,255,.35);--qr-bg:transparent}
+.finder .tip{position:absolute;bottom:22px;left:16px;right:16px;color:#fff;font-size:13px;text-align:center;line-height:1.5}
+.sheet{margin:0 -16px -14px;padding:18px 16px 16px;border-radius:var(--r-xl) var(--r-xl) 0 0;background:var(--surface-container);display:flex;flex-direction:column;gap:10px}
+[data-theme^="graphite"] .sheet{background:var(--surface);border-top:1px solid var(--outline-variant)}
+.sas{display:flex;justify-content:center;gap:8px;margin:6px 0}
+.sas span{width:36px;height:46px;border-radius:var(--r-sm);background:var(--surface-container-high);display:grid;place-items:center;font:700 22px var(--mono)}
+[data-theme^="graphite"] .sas span{background:transparent;border:1px solid var(--outline-variant)}
+/* checklist */
+.check{display:flex;gap:12px;align-items:center;padding:10px 12px;border-radius:var(--r-md);background:var(--surface-container)}
+[data-theme^="graphite"] .check{background:transparent;border:1px solid var(--outline-variant)}
+.check .st{width:28px;height:28px;border-radius:50%;display:grid;place-items:center;flex:none;background:var(--surface-container-highest);color:var(--on-surface-variant)}
+.check.done .st{background:var(--ok);color:#fff}
+[data-theme^="graphite"] .check .st{border-radius:3px}
+.check .tx{flex:1;min-width:0}.check b{font-size:13px;display:block}.check small{font-size:11.5px;color:var(--on-surface-variant)}
+.progress{height:6px;border-radius:9px;background:var(--surface-container-highest);overflow:hidden}
+.progress i{display:block;height:100%;width:60%;background:var(--primary);border-radius:9px}
+/* power cards */
+.power{border-radius:var(--r-lg);padding:13px 14px;background:var(--surface-container);border:1.5px solid transparent}
+.power.sel{border-color:var(--primary);background:color-mix(in srgb,var(--primary-container) 55%,var(--surface))}
+[data-theme^="graphite"] .power{background:transparent;border:1px solid var(--outline-variant)}
+[data-theme^="graphite"] .power.sel{border:1.5px solid var(--on-surface);box-shadow:3px 3px 0 var(--outline-variant)}
+.power .hd{display:flex;justify-content:space-between;align-items:center}
+.power h4{font-size:14.5px;font-weight:700}
+.power .eff{font-size:11px;color:var(--on-surface-variant);font-weight:600}
+.power p{font-size:11.5px;color:var(--on-surface-variant);margin-top:4px;line-height:1.45}
+.power .gets{display:flex;flex-wrap:wrap;gap:4px;margin-top:8px}
+.power .gets span{font-size:10.5px;padding:3px 7px;border-radius:var(--r-pill);background:var(--surface-container-highest)}
+[data-theme^="graphite"] .power .gets span{background:transparent;border:1px solid var(--outline-variant);font-family:var(--mono);font-size:9px;text-transform:uppercase;letter-spacing:.05em}
+.path{display:flex;gap:12px;align-items:center;padding:12px;border-radius:var(--r-md);background:var(--surface-container)}
+[data-theme^="graphite"] .path{background:transparent;border:1px solid var(--outline-variant)}
+.path .ic{width:36px;height:36px;border-radius:var(--r-sm);display:grid;place-items:center;background:var(--secondary-container);color:var(--on-secondary-container);flex:none}
+[data-theme^="graphite"] .path .ic{background:transparent;border:1px solid var(--outline-variant);color:var(--on-surface)}
+.path .tx{flex:1}.path b{font-size:13px}.path small{display:block;font-size:11.5px;color:var(--on-surface-variant);margin-top:1px}
+.rec{font-size:10px;font-weight:700;padding:2px 7px;border-radius:var(--r-pill);background:var(--primary);color:var(--on-primary);margin-left:6px;vertical-align:2px}
+[data-theme^="graphite"] .rec{font-family:var(--mono);font-weight:400;letter-spacing:.08em;border-radius:2px}
+/* notifications page */
+.col-list{width:300px;border-right:1px solid var(--outline-variant);display:flex;flex-direction:column;flex:none}
+.col-list .head{padding:14px 16px 10px;display:flex;gap:6px;flex-wrap:wrap}
+.col-list .list{padding:0 8px;overflow:hidden}
+.detail{flex:1;display:flex;flex-direction:column;min-width:0}
+.detail .dh{display:flex;gap:12px;align-items:center;padding:16px 22px;border-bottom:1px solid var(--outline-variant)}
+.detail .dh>div{min-width:0}.detail .dh h4{font-size:15px;font-weight:700}.detail .dh p{font-size:12px;color:var(--on-surface-variant);white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
+.thread{flex:1;padding:18px 22px;display:flex;flex-direction:column;gap:10px;overflow:hidden}
+.bub{max-width:70%;padding:10px 14px;border-radius:18px;font-size:13.5px;line-height:1.45;background:var(--surface-container-high);align-self:flex-start}
+.bub.me{align-self:flex-end;background:var(--primary);color:var(--on-primary)}
+[data-theme^="graphite"] .bub{border-radius:4px;background:transparent;border:1px solid var(--outline-variant)}
+[data-theme^="graphite"] .bub.me{background:var(--on-surface);color:var(--surface);border-color:var(--on-surface)}
+.bub small{display:block;font-size:10.5px;opacity:.7;margin-top:4px}
+.mms{width:210px;height:150px;border-radius:14px;align-self:flex-end;background:linear-gradient(135deg,#e9b66f,#a3542b 60%,#3d2414)}
+[data-theme^="graphite"] .mms{border-radius:3px;filter:grayscale(1) contrast(1.1)}
+.day{align-self:center;font-size:11px;color:var(--on-surface-variant)}
+.composer{margin:0 22px 18px;display:flex;align-items:center;gap:10px;padding:6px 6px 6px 16px;border-radius:var(--r-pill);background:var(--surface-container-high);font-size:13px;color:var(--on-surface-variant)}
+[data-theme^="graphite"] .composer{border-radius:4px;background:transparent;border:1px solid var(--outline)}
+.composer .send{width:38px;height:38px;border-radius:50%;background:var(--btn-bg);color:var(--btn-ink);display:grid;place-items:center;box-shadow:var(--btn-shadow)}
+[data-theme^="graphite"] .composer .send{border-radius:3px}
+.via{font-size:11px;color:var(--on-surface-variant);text-align:center;margin:-8px 0 12px}
+/* toast (native Windows style, theme-tinted accent only) */
+.toast{width:364px;border-radius:8px;background:#2B2B2B;color:#fff;box-shadow:0 16px 40px rgba(0,0,0,.35);font-family:"Segoe UI Variable Text","Segoe UI",sans-serif;padding:14px 14px 12px;font-size:13px}
+.toast .t{display:flex;gap:8px;align-items:center;font-size:12px;color:#c8c8c8}
+.toast .t i{width:16px;height:16px;border-radius:4px;background:var(--primary)}
+.toast h5{font-size:14px;margin-top:10px;font-weight:600}.toast p{color:#d6d6d6;margin-top:2px}
+.toast .reply{margin-top:12px;display:flex;gap:8px}.toast .reply span{flex:1;height:32px;border-radius:4px;background:#3a3a3a;padding:0 10px;display:flex;align-items:center;color:#9d9d9d;font-size:12.5px}
+.toast .reply b{height:32px;padding:0 14px;border-radius:4px;background:#4a4a4a;display:grid;place-items:center;font-weight:600;font-size:12.5px}
+/* mirror */
+.mwin{width:420px;height:600px;border-radius:12px;background:#1b1b1d;display:flex;flex-direction:column;overflow:hidden;box-shadow:var(--win-shadow);border:1px solid #2a2a2d;color:#e8e8ea}
+.mwin .tb{height:38px;display:flex;align-items:center;gap:10px;padding:0 12px;font-size:12.5px;background:var(--surface);color:var(--on-surface);border-bottom:1px solid var(--outline-variant)}
+.mwin .tb .ap{width:18px;height:18px;border-radius:5px}
+.mwin .tb .wc{display:flex;gap:16px;margin-left:auto;color:var(--on-surface-variant)}
+.mwin .stage{flex:1;display:flex;min-height:0}
+.mwin .ps{flex:1;display:grid;place-items:center;background:#0e0e10}
+.mwin .tools{width:52px;background:var(--surface);border-left:1px solid var(--outline-variant);display:flex;flex-direction:column;align-items:center;gap:6px;padding:12px 0;color:var(--on-surface-variant)}
+.mwin .tools span{width:36px;height:36px;border-radius:var(--r-sm);display:grid;place-items:center}
+.mwin .tools span.on{background:var(--indicator);color:var(--on-indicator)}
+.mwin .foot{height:30px;display:flex;align-items:center;gap:14px;padding:0 12px;font-size:11px;background:var(--surface);color:var(--on-surface-variant);border-top:1px solid var(--outline-variant)}
+[data-theme^="graphite"] .mwin .foot{font-family:var(--mono);letter-spacing:.08em;text-transform:uppercase;font-size:9.5px}
+.fake{width:250px;height:520px;border-radius:16px;overflow:hidden;background:#fff;color:#1d1d1f;font-family:system-ui,sans-serif;display:flex;flex-direction:column}
+.fake .ah{height:56px;background:#0f7a5f;color:#fff;display:flex;align-items:center;gap:10px;padding:0 12px;font-weight:600;font-size:14px}
+.fake .ah i{width:30px;height:30px;border-radius:50%;background:#cfe9df}
+.fake .cl{flex:1;background:#efe7dd;padding:10px;display:flex;flex-direction:column;gap:6px;font-size:12px}
+.fake .m{background:#fff;padding:7px 9px;border-radius:8px;max-width:75%}.fake .m.o{align-self:flex-end;background:#d9fdd3}
+.fake .in{height:46px;background:#f0f0f0;display:flex;align-items:center;padding:0 10px;font-size:12px;color:#888}
+.appwin{width:380px;height:600px;border-radius:12px;overflow:hidden;box-shadow:var(--win-shadow);border:1px solid var(--outline-variant);display:flex;flex-direction:column;background:#fff}
+.appwin .tb{height:36px;display:flex;align-items:center;gap:8px;padding:0 12px;font-size:12.5px;background:var(--surface);color:var(--on-surface);border-bottom:1px solid var(--outline-variant)}
+.appwin .tb small{color:var(--on-surface-variant)}
+.spot{flex:1;background:linear-gradient(180deg,#2c4a3a,#121212 55%);color:#fff;font-family:system-ui,sans-serif;padding:20px;display:flex;flex-direction:column;gap:14px}
+.spot .cv{width:100%;aspect-ratio:1;border-radius:6px;background:linear-gradient(135deg,#a8d8b9,#2d6a4f 60%,#1b3a2b)}
+.spot h4{font-size:18px}.spot p{font-size:12.5px;color:#b3b3b3}
+.spot .bar{height:4px;border-radius:4px;background:#535353}.spot .bar i{display:block;width:35%;height:100%;background:#fff;border-radius:4px}
+.spot .ctl{display:flex;justify-content:center;gap:26px;align-items:center}
+.spot .ctl b{width:52px;height:52px;border-radius:50%;background:#fff;color:#000;display:grid;place-items:center}
+/* deck */
+.dk-head{display:flex;justify-content:space-between;align-items:center}
+.dk-pages{display:flex;gap:6px}
+.dk-pages span{height:30px;padding:0 12px;border-radius:var(--r-pill);font-size:12px;font-weight:600;display:grid;place-items:center;background:var(--surface-container-high);color:var(--on-surface-variant)}
+.dk-pages span.on{background:var(--secondary-container);color:var(--on-secondary-container)}
+[data-theme^="graphite"] .dk-pages span{background:transparent;border:1px solid var(--outline-variant);font-family:var(--mono);font-weight:400;font-size:9.5px;letter-spacing:.08em;text-transform:uppercase}
+[data-theme^="graphite"] .dk-pages span.on{background:var(--on-surface);color:var(--surface)}
+.dk{display:grid;grid-template-columns:repeat(3,1fr);gap:10px}
+.key{aspect-ratio:1;border-radius:var(--r-lg);background:var(--surface-container);display:flex;flex-direction:column;justify-content:space-between;padding:11px;font-size:11.5px;font-weight:600}
+.key .ic{width:30px;height:30px;border-radius:var(--r-sm);display:grid;place-items:center;background:var(--surface-container-highest)}
+.key.active{background:var(--primary);color:var(--on-primary)}
+.key.active .ic{background:color-mix(in srgb,var(--on-primary) 18%,transparent)}
+.key small{font-weight:400;font-size:10px;opacity:.75;display:block}
+[data-theme^="graphite"] .key{background:transparent;border:1px solid var(--outline-variant)}
+[data-theme^="graphite"] .key .ic{background:transparent;border:1px solid var(--outline-variant)}
+[data-theme^="graphite"] .key.active{background:var(--on-surface);color:var(--surface);border-color:var(--on-surface)}
+.key.add{border:1.5px dashed var(--outline-variant);background:transparent;align-items:center;justify-content:center;color:var(--on-surface-variant)}
+/* settings */
+.set-nav{width:220px;border-right:1px solid var(--outline-variant);padding:14px 10px;flex:none}
+.set-main{flex:1;padding:20px 26px;overflow:hidden;display:flex;flex-direction:column;gap:14px}
+.lvl{display:flex;gap:16px;align-items:center;padding:16px;border-radius:var(--r-xl);background:var(--hero-bg);color:var(--hero-ink);border:1px solid var(--card-border)}
+.lvl .big{width:52px;height:52px;border-radius:var(--r-md);display:grid;place-items:center;background:var(--primary);color:var(--on-primary)}
+[data-theme^="graphite"] .lvl .big{border-radius:3px}
+.lvl h4{font-family:var(--display);font-weight:var(--display-weight);font-size:22px;letter-spacing:var(--display-track)}
+.lvl p{font-size:12.5px;opacity:.8;margin-top:2px}
+.feat{display:flex;align-items:center;gap:12px;padding:11px 0;border-top:1px solid var(--outline-variant);font-size:13px}
+.feat:first-of-type{border-top:0}
+.feat .tx{flex:1}.feat small{display:block;font-size:11.5px;color:var(--on-surface-variant);margin-top:1px}
+.feat.off{color:var(--on-surface-variant)}
+.state{font-size:11px;font-weight:600;padding:3px 8px;border-radius:var(--r-pill);background:color-mix(in srgb,var(--ok) 16%,transparent);color:var(--ok)}
+.state.partial{background:color-mix(in srgb,var(--warn) 16%,transparent);color:var(--warn)}
+[data-theme^="graphite"] .state{font-family:var(--mono);font-weight:400;letter-spacing:.06em;text-transform:uppercase;font-size:9.5px;background:transparent;border:1px solid currentColor;border-radius:2px}
+</style>
+</head>
+<body data-theme="bloom-light">
+<div class="bar">
+ <div class="brand">Nectarlink <span>· Mockups</span></div>
+ <div class="seg" id="themes">
+ <button data-t="bloom-light" class="on">Bloom Light</button><button data-t="bloom-dark">Bloom Dark</button>
+ <button data-t="graphite-paper">Graphite Paper</button><button data-t="graphite-slate">Graphite Slate</button>
+ </div>
+ <div class="seeds" id="seeds">Material You
+ <button data-s="honey" class="on" style="background:#B7791F" title="Honey"></button><button data-s="sage" style="background:#5B8C5A" title="Sage"></button>
+ <button data-s="lavender" style="background:#7E6AA8" title="Lavender"></button><button data-s="ocean" style="background:#3D7DA8" title="Ocean"></button>
+ </div>
+</div>
+
+<div class="toc">
+ <span class="kicker">Phase 0 · Design</span>
+ <h1>Core screens</h1>
+ <p>The key flows in both themes. Same components, same layout; only the tokens change. Content is placeholder. Switch themes and Material You seeds at the top.</p>
+ <nav><a href="#pair">1 · Pairing</a><a href="#onboard">2 · Phone setup</a><a href="#power">3 · Choose your power</a><a href="#notif">4 · Notifications</a><a href="#msgs">5 · Messages</a><a href="#mirror">6 · Mirroring & app windows</a><a href="#deck">7 · Deck</a><a href="#settings">8 · Power settings</a></nav>
+</div>
+
+<main id="screens"></main>
+
+<script src="../assets/nl.js"></script>
+<script>
+const rail = (on) => `<aside class="rail"><div class="mark">${i('hex')}</div>
+ ${[['home','Home'],['msg','Messages'],['bell','Alerts'],['photo','Photos'],['apps','Apps'],['deck','Deck']].map(([ic,l])=>`<div class="nav ${l===on?'on':''}"><i>${i(ic)}</i>${l}</div>`).join('')}
+ <div class="spacer"></div><div class="nav ${on==='Settings'?'on':''}"><i>${i('gear')}</i>Settings</div></aside>`;
+const topbar = (t) => `<header class="top"><h3>${t}</h3><span class="status"><span class="dot"></span>Pixel 9 · Wi-Fi · 12 ms</span><span class="fill"></span></header>`;
+const phone = (inner, cls='') => `<div class="phone"><div class="scr ${cls}"><div class="cam"></div><div class="sb"><span>9:41</span><span>82%</span></div>${inner}</div></div>`;
+const set = (id, k, h, p, body) => `<section class="screen-set" id="${id}"><div class="set-head"><span class="kicker">${k}</span><h2>${h}</h2><p>${p}</p></div><div class="row">${body}</div></section>`;
+
+document.getElementById('screens').innerHTML =
+
+set('pair','1 · First run','Pair in under a minute',
+ 'The PC shows a QR code; the phone scans it and both sides are paired and authenticated, with no codes to type. Nearby pairing (6-digit code check) and USB pairing are one click away.',
+ `<div class="win sm"><div class="main">
+ <header class="top"><h3>Welcome to Nectarlink</h3><span class="fill"></span><span class="cap">Step 1 of 2</span></header>
+ <div class="pair">
+ <div class="crop"><i></i><i></i><i></i><i></i><div class="qrbox">${qrSVG()}</div></div>
+ <span class="G cap">Fig. 00 // Pairing code</span>
+ <h2>Scan with your phone</h2>
+ <div class="steps"><span><b>1</b>Install Nectarlink</span><span><b>2</b>Tap “Pair with PC”</span><span><b>3</b>Scan this code</span></div>
+ <div class="alt"><button class="btn tonal sm">${i('wifi')}Pair nearby instead</button><button class="btn out sm">${i('usb')}Use a USB cable</button></div>
+ <span class="timer">Code refreshes in 4:12 · Only works on this network</span>
+ </div></div></div>
+ <div>${phone(`<div class="finder"><div class="frame"><i></i><i></i><i></i><i></i><div class="ghost">${qrSVG(25,7)}</div></div>
+ <div class="tip">Point your camera at the code on your PC</div></div>
+ <div class="sheet"><b style="font-size:14px">Found “Bee's Desktop”</b><span class="hint">Windows 11 · on Home Wi-Fi</span><button class="btn fill wide">Pair</button></div>`)}
+ <p class="caption"><b>Scan.</b> The phone finds the PC from the code and pairs securely.</p></div>
+ <div>${phone(`<div class="ph-title" style="margin-top:8px">Check the code</div>
+ <p class="ph-sub">Make sure this matches the code on <b>Bee's Desktop</b>. This keeps anyone else from pairing in between.</p>
+ <div class="sas"><span>4</span><span>8</span><span>2</span><span>9</span><span>1</span><span>3</span></div>
+ <div class="card" style="display:flex;gap:10px;align-items:center"><span class="av p">${i('screen')}</span><div><b style="font-size:13px">Bee's Desktop</b><div class="hint">Windows 11 · nearby</div></div></div>
+ <div style="margin-top:auto;display:flex;flex-direction:column;gap:8px"><button class="btn fill wide">Codes match</button><button class="btn text wide">They don't match</button></div>`)}
+ <p class="caption"><b>Nearby pairing.</b> No camera needed; both screens show the same 6 digits.</p></div>`) +
+
+set('onboard','2 · Phone setup','One live checklist',
+ 'Every permission shows its real state, why it is needed, and one tap to grant it. Nothing is buried in settings, and the list updates the moment a permission is granted.',
+ `<div>${phone(`<div class="ph-title" style="margin-top:6px">Almost there</div>
+ <p class="ph-sub">Give Nectarlink what it needs. You can change any of this later.</p>
+ <div class="progress"><i></i></div>
+ <div class="check done"><span class="st">${i('check')}</span><div class="tx"><b>Notifications</b><small>Show your phone's alerts on your PC</small></div></div>
+ <div class="check done"><span class="st">${i('check')}</span><div class="tx"><b>Messages & calls</b><small>Texts, call alerts and contacts</small></div></div>
+ <div class="check done"><span class="st">${i('check')}</span><div class="tx"><b>Photos & files</b><small>Send and browse from your PC</small></div></div>
+ <div class="check"><span class="st">${i('bolt')}</span><div class="tx"><b>Stay connected</b><small>Allow running in the background</small></div><button class="btn tonal sm">Allow</button></div>
+ <div class="check"><span class="st">${i('bell')}</span><div class="tx"><b>Restricted settings</b><small>Needed because the app came from GitHub</small></div><button class="btn tonal sm">Show me</button></div>
+ <button class="btn fill wide" style="margin-top:auto">Continue</button>`)}
+ <p class="caption"><b>Checklist.</b> States are live; sideloaded installs get a guided “Allow restricted settings” step.</p></div>
+ <div>${phone(`<div style="display:flex;justify-content:space-between;align-items:center;margin-top:6px"><span class="ph-title">Nectarlink</span><span class="av p">B</span></div>
+ <div class="card" style="background:var(--hero-bg);color:var(--hero-ink);border-radius:var(--r-xl)"><span class="G cap">Fig. 02 // Linked to</span><div class="ph-title" style="font-size:21px">Bee's Desktop</div><div class="hint" style="color:inherit;opacity:.8">Connected · Wi-Fi · 12 ms</div>
+ <div style="display:flex;gap:6px;margin-top:10px"><span class="chip">Laptop 64%</span><span class="chip">Basic</span></div></div>
+ <div class="card" style="display:flex;gap:12px;align-items:center"><span class="av p">${i('bolt')}</span><div style="flex:1"><b style="font-size:13px">Unlock more</b><div class="hint">Auto clipboard, OTP codes, app windows</div></div>${i('chev')}</div>
+ <div class="card"><div class="lbl" style="margin-bottom:8px">Recent</div><div class="hint">IMG_2041.jpg · sent to PC · now</div></div>
+ <div class="tabbar"><span class="on">${i('home')}</span><span>${i('send')}</span><span>${i('deck')}</span><span>${i('gear')}</span></div>`)}
+ <p class="caption"><b>Home.</b> A gentle “Unlock more” card instead of nagging. It disappears once you choose.</p></div>`) +
+
+set('power','3 · Choose your power','Pick how much Nectarlink can do',
+ 'Three clear levels, each showing what it unlocks, what it needs, how long it takes and how to undo it. A smart default is pre-selected; “Decide later” is always available.',
+ `<div>${phone(`<div class="ph-title" style="margin-top:4px">Choose your power</div>
+ <p class="ph-sub">Everything works at Basic. More access unlocks more.</p>
+ <div class="power"><div class="hd"><h4>Basic</h4><span class="eff">Ready now</span></div><p>Notifications, messages, calls, files, media, webcam.</p></div>
+ <div class="power sel"><div class="hd"><h4>Elevated <span class="rec">Recommended</span></h4><span class="eff">~2 min</span></div><p>One-time setup. No extra apps. Undo anytime.</p>
+ <div class="gets"><span>Auto clipboard</span><span>OTP codes</span><span>App windows</span><span>Full control</span><span>Phone audio</span></div></div>
+ <div class="power"><div class="hd"><h4>Root</h4><span class="eff">Detected: no</span></div><p>For rooted phones. Survives reboots.</p></div>
+ <div style="margin-top:auto;display:flex;flex-direction:column;gap:6px"><button class="btn fill wide">Set up Elevated</button><button class="btn text wide">Decide later</button></div>`)}
+ <p class="caption"><b>Levels.</b> Plain language, honest effort estimates, and a “what this access means” explainer behind each card.</p></div>
+ <div>${phone(`<div style="display:flex;align-items:center;gap:6px;margin-top:4px;color:var(--on-surface-variant)">${i('back')}<span class="cap">Elevated setup</span></div>
+ <div class="ph-title">How do you want to set it up?</div>
+ <p class="ph-sub">Pick whichever is easiest right now.</p>
+ <div class="path"><span class="ic">${i('wifi')}</span><div class="tx"><b>Scan from your PC</b><span class="rec">Best</span><small>Wireless debugging · no cable</small></div>${i('chev')}</div>
+ <div class="path"><span class="ic">${i('usb')}</span><div class="tx"><b>Plug into your PC</b><small>USB debugging · 1 min</small></div>${i('chev')}</div>
+ <div class="path"><span class="ic">${i('handset')}</span><div class="tx"><b>On this phone only</b><small>No PC needed · Android 11+</small></div>${i('chev')}</div>
+ <div class="path"><span class="ic">${i('shield')}</span><div class="tx"><b>Use Shizuku</b><small>Already installed · 1 tap</small></div>${i('chev')}</div>
+ <p class="hint" style="margin-top:auto">Nectarlink starts a helper with developer access, built into this app. It never leaves your phone and you can revoke it in Settings.</p>`)}
+ <p class="caption"><b>Setup paths.</b> Recommended path chosen from what's detected (Android version, USB, Shizuku, root).</p></div>`) +
+
+set('notif','4 · Notifications','Your phone’s alerts, organized',
+ 'Native Windows toasts with replies and actions for the moment, and a calm feed in the app for everything else: filter by app, reply inline, copy codes in one click.',
+ `<div class="win">${rail('Alerts')}<div class="main">${topbar('Notifications')}
+ <div class="body"><div class="col-list">
+ <div class="head"><span class="chip on">All</span><span class="chip">Messages</span><span class="chip">Codes</span><span class="chip">${i('filter')}Apps</span></div>
+ <div class="list">
+ <div class="it"><span class="av">G</span><div class="tx"><h5>Google<span>now</span></h5><p>Sign-in code for your account</p></div></div>
+ <div class="it on"><span class="av p">M</span><div class="tx"><h5>Mom · WhatsApp<span>2m</span></h5><p>Dinner at 8? Bring the charger…</p></div><span class="badge">2</span></div>
+ <div class="it"><span class="av">S</span><div class="tx"><h5>Swiggy<span>18m</span></h5><p>Arriving in 12 min</p></div></div>
+ <div class="it"><span class="av">C</span><div class="tx"><h5>Calendar<span>1h</span></h5><p>Design review at 4:30 PM</p></div></div>
+ <div class="it"><span class="av">D</span><div class="tx"><h5>Discord<span>2h</span></h5><p>#general: 6 new messages</p></div></div>
+ </div></div>
+ <div class="detail"><div class="dh"><span class="av p">M</span><div><h4>Mom</h4><p>WhatsApp · via Pixel 9</p></div><span class="fill"></span><button class="btn text sm">Open on phone</button></div>
+ <div class="thread"><span class="day">Today</span>
+ <div class="bub">Are you coming home this weekend?<small>11:02</small></div>
+ <div class="bub me">Yes! Saturday morning 🙂<small>11:05</small></div>
+ <div class="bub">Dinner at 8? Bring the charger you borrowed.<small>11:40</small></div></div>
+ <div class="composer">Reply to Mom…<span class="fill"></span><span class="send">${i('send')}</span></div>
+ <div class="via">Replies are sent through WhatsApp on your phone</div></div></div></div></div>
+ <div style="display:flex;flex-direction:column;gap:14px">
+ <div class="toast"><div class="t"><i></i>Nectarlink · Pixel 9<span class="fill"></span>now</div><h5>Mom · WhatsApp</h5><p>Dinner at 8? Bring the charger you borrowed.</p><div class="reply"><span>Type a reply</span><b>Send</b></div></div>
+ <div class="toast"><div class="t"><i></i>Nectarlink · Pixel 9<span class="fill"></span>now</div><h5>Google</h5><p>Your sign-in code is 482 913</p><div class="reply"><b style="flex:1">Copy code</b><b>Dismiss</b></div></div>
+ <p class="caption" style="max-width:364px"><b>Toasts.</b> Native Windows style for system consistency; only the small app badge picks up the theme accent.</p>
+ </div>`) +
+
+set('msgs','5 · Messages','Texts and chat apps in one inbox',
+ 'SMS and MMS directly, plus RCS, WhatsApp, Telegram and others through their notifications. Drag an image in to send it. It is always clear which app a reply goes through.',
+ `<div class="win">${rail('Messages')}<div class="main">${topbar('Messages')}
+ <div class="body"><div class="col-list">
+ <div class="head" style="padding-bottom:12px"><div class="chip" style="flex:1;justify-content:flex-start">${i('search')}Search messages</div><button class="btn fill sm" style="padding:0 10px">${i('plus')}</button></div>
+ <div class="list">
+ <div class="it on"><span class="av p">A</span><div class="tx"><h5>Aanya<span>4:12 PM</span></h5><p>Look at this view!!</p></div></div>
+ <div class="it"><span class="av">M</span><div class="tx"><h5>Mom<span>11:40</span></h5><p>Dinner at 8?</p></div><span class="badge">2</span></div>
+ <div class="it"><span class="av">R</span><div class="tx"><h5>Rahul · Telegram<span>Tue</span></h5><p>Pushed the fix, check it</p></div></div>
+ <div class="it"><span class="av">H</span><div class="tx"><h5>HDFC Bank<span>Mon</span></h5><p>Your statement is ready</p></div></div>
+ <div class="it"><span class="av">K</span><div class="tx"><h5>Kabir<span>Sun</span></h5><p>Game night at mine?</p></div></div>
+ </div></div>
+ <div class="detail"><div class="dh"><span class="av p">A</span><div><h4>Aanya</h4><p>+91 98xxx xxx21 · SMS / MMS</p></div><span class="fill"></span><button class="btn out sm">Call from phone</button></div>
+ <div class="thread"><span class="day">Today</span>
+ <div class="bub">Reached the top finally</div>
+ <div class="mms"></div>
+ <div class="bub me">Look at this view!!<small>Delivered · 4:12 PM</small></div>
+ <div class="bub">Okay I'm jealous 😭<small>4:13 PM</small></div></div>
+ <div class="composer">${i('attach')}Text message<span class="fill"></span>${i('emoji')}<span class="send">${i('send')}</span></div>
+ <div class="via">Sent as SMS from Pixel 9 · SIM 1</div></div></div></div></div>`) +
+
+set('mirror','6 · Mirroring & app windows','Your phone, or just one app, on your PC',
+ 'Full-screen mirroring with a slim side toolbar, or any phone app in its own resizable window with a taskbar icon. Video is decoded on the GPU and drawn with no extra copies.',
+ `<div><div class="mwin"><div class="tb"><span class="ap" style="background:var(--primary)"></span>Pixel 9<span class="cap" style="margin-left:4px">Mirroring</span><div class="wc">— ▢ ✕</div></div>
+ <div class="stage"><div class="ps"><div class="fake"><div class="ah"><i></i>Aanya</div><div class="cl"><div class="m">Reached the top finally</div><div class="m o">Look at this view!!</div><div class="m">Okay I'm jealous 😭</div></div><div class="in">Message</div></div></div>
+ <div class="tools"><span class="on">${i('kb')}</span><span>${i('vol')}</span><span>${i('rotate')}</span><span>${i('camera')}</span><span>${i('clip')}</span><div class="spacer"></div><span>${i('screen')}</span></div></div>
+ <div class="foot"><span>1080p · 60 fps</span><span>34 ms</span><span>Audio on</span><span class="fill"></span><span>Screen off on phone</span></div></div>
+ <p class="caption"><b>Mirror window.</b> Keyboard, audio, rotate, screenshot and clipboard tools; phone screen can stay off.</p></div>
+ <div><div class="appwin"><div class="tb"><span style="width:18px;height:18px;border-radius:50%;background:#1DB954"></span>Spotify <small>· on Pixel 9</small><span class="fill"></span><small>— ▢ ✕</small></div>
+ <div class="spot"><div class="cv"></div><div><h4>Saturn</h4><p>SZA</p></div><div class="bar"><i></i></div><div class="ctl">${i('prev')}<b>${i('pause')}</b>${i('next')}</div></div></div>
+ <p class="caption"><b>App window.</b> Runs on a virtual display (Elevated): resize it, pin it to the taskbar, use it while the phone does something else.</p></div>`) +
+
+set('deck','7 · Deck','A macro pad in your pocket',
+ 'Turn the phone into a Stream-Deck-style controller for the PC: live tiles for mic, media, scenes, apps and scripts, in pages. Edited on either device.',
+ `<div>${phone(`<div class="dk-head" style="margin-top:6px"><span class="ph-title">Deck</span><button class="btn text sm">Edit</button></div>
+ <div class="dk-pages"><span class="on">Work</span><span>Stream</span><span>Media</span></div>
+ <div class="dk">
+ <div class="key active"><span class="ic">${i('mic')}</span><div>Mic<small>Muted</small></div></div>
+ <div class="key"><span class="ic">${i('play')}</span><div>Play / pause<small>Spotify</small></div></div>
+ <div class="key"><span class="ic">${i('moon')}</span><div>Focus<small>Off</small></div></div>
+ <div class="key"><span class="ic">${i('code')}</span><div>VS Code<small>Launch</small></div></div>
+ <div class="key"><span class="ic">${i('obs')}</span><div>Scene 2<small>OBS</small></div></div>
+ <div class="key"><span class="ic">${i('lock')}</span><div>Lock PC<small>Win + L</small></div></div>
+ <div class="key"><span class="ic">${i('folder')}</span><div>Downloads<small>Open</small></div></div>
+ <div class="key"><span class="ic">${i('screen')}</span><div>Screenshot<small>Region</small></div></div>
+ <div class="key add">${i('plus')}</div>
+ </div>
+ <p class="hint">Haptic tap on every press. Tiles show live state from your PC.</p>
+ <div class="tabbar"><span>${i('home')}</span><span>${i('send')}</span><span class="on">${i('deck')}</span><span>${i('gear')}</span></div>`)}
+ <p class="caption"><b>Deck.</b> Pages, live state (the mic tile shows it's muted), and an add tile.</p></div>`) +
+
+set('settings','8 · Power settings','What works, what doesn’t, and why',
+ 'The capability matrix made visible: every feature shows whether it is on, partly working, or locked, and locked items open exactly the setup they need.',
+ `<div class="win">${rail('Settings')}<div class="main">${topbar('Settings')}
+ <div class="body"><div class="set-nav list">
+ <div class="it"><span>${i('screen')}</span><div class="tx"><h5>Devices</h5></div></div>
+ <div class="it on"><span>${i('bolt')}</span><div class="tx"><h5>Power</h5></div></div>
+ <div class="it"><span>${i('wifi')}</span><div class="tx"><h5>Connections</h5></div></div>
+ <div class="it"><span>${i('bell')}</span><div class="tx"><h5>Notifications</h5></div></div>
+ <div class="it"><span>${i('apps')}</span><div class="tx"><h5>Add-ons</h5></div></div>
+ <div class="it"><span>${i('photo')}</span><div class="tx"><h5>Appearance</h5></div></div>
+ </div>
+ <div class="set-main">
+ <div class="lvl"><span class="big">${i('bolt')}</span><div style="flex:1"><span class="G cap">Fig. 03 // Current level</span><h4>Elevated</h4><p>Set up over Wi-Fi from this PC · re-arms automatically after reboots</p></div><button class="btn out sm">Revoke</button></div>
+ <div class="card" style="padding:4px 16px">
+ <div class="feat"><div class="tx">Notifications<small>Including one-time codes</small></div><span class="state">On</span></div>
+ <div class="feat"><div class="tx">Clipboard<small>Automatic in both directions</small></div><span class="state">On</span></div>
+ <div class="feat"><div class="tx">App windows<small>Phone apps in their own windows</small></div><span class="state">On</span></div>
+ <div class="feat"><div class="tx">Call audio on PC<small>Bluetooth calling is not set up</small></div><span class="state partial">Partial</span><button class="btn text sm">Set up</button></div>
+ <div class="feat off"><div class="tx">Use phone as webcam<small>Needs the virtual camera add-on</small></div><span class="lock">${i('lock')}Add-on · 1 min</span></div>
+ <div class="feat off"><div class="tx">Reach phone away from home<small>Off · uses encrypted relays</small></div><span class="switch"></span></div>
+ </div></div></div></div></div>`);
+
+setupThemeBar();
+</script>
+</body>
+</html>
diff --git a/docs/design/tokens.json b/docs/design/tokens.json
new file mode 100644
index 0000000..50ffac2
--- /dev/null
+++ b/docs/design/tokens.json
@@ -0,0 +1,150 @@
+{
+ "$schema": "nectarlink-design-tokens/v1",
+ "$description": "Single source of truth for Nectarlink design tokens. QML (desktop) and Compose (Android) themes are generated from this file. Bloom colors follow Material You tonal roles; at runtime the Android app derives them from the wallpaper and sends the seed to the PC (hello.device.accent). The palettes here are the fallbacks and brand presets.",
+
+ "themes": {
+ "bloom": {
+ "description": "Default. Minimal Material You: neutral surfaces, color only where it carries meaning.",
+ "dynamicColor": true,
+ "defaultSeed": "honey",
+ "seeds": {
+ "honey": {
+ "seed": "#B7791F",
+ "light": {
+ "primary": "#8A5100", "onPrimary": "#FFFFFF", "primaryContainer": "#FFDDB8", "onPrimaryContainer": "#2C1600",
+ "secondaryContainer": "#F3E0CB", "onSecondaryContainer": "#261A0C",
+ "surface": "#FFF8F3", "surfaceContainerLow": "#FBF2EB", "surfaceContainer": "#F5ECE4", "surfaceContainerHigh": "#EFE6DE", "surfaceContainerHighest": "#E9E1D9",
+ "onSurface": "#1F1B16", "onSurfaceVariant": "#51453A", "outline": "#837468", "outlineVariant": "#D5C3B5"
+ },
+ "dark": {
+ "primary": "#FFB95F", "onPrimary": "#4A2800", "primaryContainer": "#693C00", "onPrimaryContainer": "#FFDDB8",
+ "secondaryContainer": "#574330", "onSecondaryContainer": "#F3E0CB",
+ "surface": "#17130E", "surfaceContainerLow": "#120E0A", "surfaceContainer": "#241F1A", "surfaceContainerHigh": "#2E2924", "surfaceContainerHighest": "#39342E",
+ "onSurface": "#EBE1D9", "onSurfaceVariant": "#D5C3B5", "outline": "#9E8E81", "outlineVariant": "#51453A"
+ }
+ },
+ "sage": {
+ "seed": "#5B8C5A",
+ "light": {
+ "primary": "#3B6939", "onPrimary": "#FFFFFF", "primaryContainer": "#BCF0B4", "onPrimaryContainer": "#002204",
+ "secondaryContainer": "#D6E8CF", "onSecondaryContainer": "#111F0F",
+ "surface": "#F7FBF1", "surfaceContainerLow": "#F1F5EB", "surfaceContainer": "#EBEFE5", "surfaceContainerHigh": "#E6E9E0", "surfaceContainerHighest": "#E0E4DA",
+ "onSurface": "#191D17", "onSurfaceVariant": "#424940", "outline": "#72796F", "outlineVariant": "#C2C8BD"
+ },
+ "dark": {
+ "primary": "#A1D39A", "onPrimary": "#0A390F", "primaryContainer": "#234F24", "onPrimaryContainer": "#BCF0B4",
+ "secondaryContainer": "#3B4B38", "onSecondaryContainer": "#D6E8CF",
+ "surface": "#10140F", "surfaceContainerLow": "#0C100B", "surfaceContainer": "#1D211B", "surfaceContainerHigh": "#272B25", "surfaceContainerHighest": "#32362F",
+ "onSurface": "#E0E4DA", "onSurfaceVariant": "#C2C8BD", "outline": "#8C9388", "outlineVariant": "#424940"
+ }
+ },
+ "lavender": {
+ "seed": "#7E6AA8",
+ "light": {
+ "primary": "#65558F", "onPrimary": "#FFFFFF", "primaryContainer": "#E9DDFF", "onPrimaryContainer": "#201047",
+ "secondaryContainer": "#E8DEF8", "onSecondaryContainer": "#1D192B",
+ "surface": "#FDF7FF", "surfaceContainerLow": "#F7F2FA", "surfaceContainer": "#F2ECF4", "surfaceContainerHigh": "#ECE6EE", "surfaceContainerHighest": "#E6E0E9",
+ "onSurface": "#1D1B20", "onSurfaceVariant": "#49454E", "outline": "#7A757F", "outlineVariant": "#CAC4CF"
+ },
+ "dark": {
+ "primary": "#CFBDFE", "onPrimary": "#36275D", "primaryContainer": "#4D3D75", "onPrimaryContainer": "#E9DDFF",
+ "secondaryContainer": "#4A4458", "onSecondaryContainer": "#E8DEF8",
+ "surface": "#141218", "surfaceContainerLow": "#0F0D13", "surfaceContainer": "#211F24", "surfaceContainerHigh": "#2B292F", "surfaceContainerHighest": "#36343A",
+ "onSurface": "#E6E0E9", "onSurfaceVariant": "#CAC4CF", "outline": "#948F99", "outlineVariant": "#49454E"
+ }
+ },
+ "ocean": {
+ "seed": "#3D7DA8",
+ "light": {
+ "primary": "#2F628C", "onPrimary": "#FFFFFF", "primaryContainer": "#CEE5FF", "onPrimaryContainer": "#001D33",
+ "secondaryContainer": "#D5E4F7", "onSecondaryContainer": "#0E1D2A",
+ "surface": "#F7F9FF", "surfaceContainerLow": "#F1F4FA", "surfaceContainer": "#ECEEF4", "surfaceContainerHigh": "#E6E8EE", "surfaceContainerHighest": "#E0E2E8",
+ "onSurface": "#181C20", "onSurfaceVariant": "#42474E", "outline": "#72777F", "outlineVariant": "#C2C7CF"
+ },
+ "dark": {
+ "primary": "#9BCBFB", "onPrimary": "#003354", "primaryContainer": "#0F4A73", "onPrimaryContainer": "#CEE5FF",
+ "secondaryContainer": "#3B4858", "onSecondaryContainer": "#D5E4F7",
+ "surface": "#101418", "surfaceContainerLow": "#0B0F13", "surfaceContainer": "#1C2024", "surfaceContainerHigh": "#262A2F", "surfaceContainerHighest": "#31353A",
+ "onSurface": "#E0E2E8", "onSurfaceVariant": "#C2C7CF", "outline": "#8C9199", "outlineVariant": "#42474E"
+ }
+ }
+ },
+ "status": { "light": { "success": "#2E7D4F", "warning": "#9A6700", "error": "#BA1A1A", "onError": "#FFFFFF" },
+ "dark": { "success": "#7BD8A0", "warning": "#F2C14E", "error": "#FFB4AB", "onError": "#690005" } },
+ "shape": { "xs": 8, "sm": 12, "md": 16, "lg": 20, "xl": 28, "full": 999 },
+ "fonts": { "ui": "Figtree", "display": "Figtree", "label": "Figtree", "mono": "Space Mono" },
+ "label": { "case": "none", "tracking": 0, "size": 12.5, "weight": 600 }
+ },
+
+ "graphite": {
+ "description": "Built-in alternative, from github.com/thtbee/graphite. Monochrome ink on paper / chalk on slate; dynamic color off.",
+ "dynamicColor": false,
+ "variants": {
+ "paper": {
+ "primary": "#1A1918", "onPrimary": "#F5F2EB", "primaryContainer": "#E8E3D7", "onPrimaryContainer": "#1A1918",
+ "secondaryContainer": "#E8E3D7", "onSecondaryContainer": "#1A1918",
+ "surface": "#F5F2EB", "surfaceContainerLow": "#F1EDE4", "surfaceContainer": "#F5F2EB", "surfaceContainerHigh": "#EFEBE2", "surfaceContainerHighest": "#E8E3D7",
+ "onSurface": "#1A1918", "onSurfaceVariant": "#5E5A54", "outline": "#4A4743", "outlineVariant": "#D5CFC2",
+ "success": "#3F6B4A", "warning": "#8A6A1F", "error": "#9E2B25", "onError": "#F5F2EB",
+ "buttonShadow": "3px 3px 0 #D5CFC2", "grain": 0.22, "grid": "rgba(74,71,67,0.06)"
+ },
+ "slate": {
+ "primary": "#E8EAED", "onPrimary": "#0D0D0E", "primaryContainer": "#1A1A1D", "onPrimaryContainer": "#E8EAED",
+ "secondaryContainer": "#1A1A1D", "onSecondaryContainer": "#E8EAED",
+ "surface": "#0D0D0E", "surfaceContainerLow": "#0B0B0C", "surfaceContainer": "#0D0D0E", "surfaceContainerHigh": "#141416", "surfaceContainerHighest": "#1A1A1D",
+ "onSurface": "#E8EAED", "onSurfaceVariant": "#9A9CA1", "outline": "#7E8084", "outlineVariant": "#26272A",
+ "success": "#8FC7A0", "warning": "#E2C47A", "error": "#F0A39C", "onError": "#0D0D0E",
+ "buttonShadow": "3px 3px 0 #26272A", "grain": 0.12, "grid": "rgba(200,208,216,0.035)"
+ }
+ },
+ "shape": { "xs": 2, "sm": 3, "md": 4, "lg": 4, "xl": 6, "full": 3 },
+ "fonts": { "ui": "Figtree", "display": "Instrument Serif", "label": "Space Mono", "mono": "Space Mono", "note": "Caveat" },
+ "label": { "case": "upper", "tracking": 0.12, "size": 10.5, "weight": 400 },
+ "rules": [
+ "Cards use 1px outlineVariant borders, no fills, no elevation.",
+ "Primary buttons are ink-filled with the flat offset buttonShadow.",
+ "Crop marks frame hero imagery; 'FIG. NN // ...' annotations label sections.",
+ "At most one handwritten (Caveat) margin note per screen, only for delight moments.",
+ "Never use Graphite's art effects in the app: no smudge physics, no gritty lettering, no scroll sound."
+ ]
+ }
+ },
+
+ "typography": {
+ "displayLarge": { "size": 44, "lineHeight": 1.05, "weight": 650, "tracking": -0.025 },
+ "displaySmall": { "size": 30, "lineHeight": 1.1, "weight": 650, "tracking": -0.02 },
+ "headline": { "size": 22, "lineHeight": 1.2, "weight": 650, "tracking": -0.015 },
+ "title": { "size": 16, "lineHeight": 1.35, "weight": 600, "tracking": 0 },
+ "body": { "size": 14, "lineHeight": 1.5, "weight": 400, "tracking": 0 },
+ "bodySmall": { "size": 12.5, "lineHeight": 1.45, "weight": 400, "tracking": 0 },
+ "label": { "size": 12.5, "lineHeight": 1.3, "weight": 600, "tracking": 0 },
+ "caption": { "size": 11, "lineHeight": 1.3, "weight": 500, "tracking": 0 },
+ "code": { "size": 13, "lineHeight": 1.3, "weight": 700, "tracking": 0.14, "font": "mono" }
+ },
+
+ "spacing": { "unit": 4, "scale": [0, 2, 4, 6, 8, 10, 12, 16, 20, 24, 32, 40, 48, 64] },
+
+ "layout": {
+ "desktop": { "railWidth": 80, "topBarHeight": 52, "contentPadding": 22, "gutter": 16, "minWindow": [880, 600] },
+ "phone": { "screenPadding": 16, "gutter": 10, "tabBarHeight": 64 }
+ },
+
+ "elevation": {
+ "bloom": { "level0": "none", "level1": "0 1px 2px rgba(0,0,0,.06)", "window": "0 1px 2px rgba(0,0,0,.06), 0 24px 60px -20px rgba(0,0,0,.18)" },
+ "graphite": { "level0": "none", "level1": "none", "window": "0 30px 70px -30px rgba(0,0,0,.35)" }
+ },
+
+ "motion": {
+ "description": "Springs everywhere; durations are only for fades. Respect reduced-motion: replace movement with 120 ms fades.",
+ "spring": {
+ "gentle": { "stiffness": 220, "damping": 26, "use": "page and panel transitions" },
+ "standard": { "stiffness": 380, "damping": 30, "use": "cards, sheets, expanding a notification into a conversation" },
+ "snappy": { "stiffness": 620, "damping": 34, "use": "toggles, chips, buttons, hover lift" }
+ },
+ "fade": { "fast": 120, "normal": 200 },
+ "hoverLift": 2,
+ "pressScale": 0.97
+ },
+
+ "icons": { "set": "Material Symbols Rounded (Apache-2.0)", "size": 20, "stroke": "outlined, 400 weight; filled when selected" }
+}