# MicProtocol Design System — "Golden Studio" Version 2.0 · November 2026 · Source of truth: `packages/design-tokens/src/index.ts` This document is the UI/UX specification for every surface of MicProtocol: tokens, components, page-by-page layouts, and the reference designs they draw from (Dribbble, and how to keep a Pinterest board per area in sync). The token values in this doc are live in code — changing `packages/design-tokens` re-themes Web (CSS custom properties), Mobile (Tamagui), and `packages/ui` at once. --- ## 1. Design direction ### The brief MicProtocol is a podcast guest-management platform: hosts run a recruitment pipeline, book and record episodes, manage a verified guest network, take payments, and sell tickets. The product's world is **studios, record lights, VU meters, timecodes, and stage schedules** — not generic SaaS chrome. The previous system ("Midnight Obsidian") read cold and brittle: purple-tinted near-black surfaces, 1–4px corners on everything, and hard industrial shadows fighting the amber glow. It looked like a dark-mode template, not a studio. ### The new direction **A broadcast control room after hours.** Dim, warm, low-light surfaces like a stripped studio at night; one light does the talking — the amber **record light**. Everything else supports it. | Decision | Value | Why (grounded in subject matter) | |---|---|---| | Warm charcoal surfaces | `#100E0C → #242019` ramp | A control room is dark but never jet black; foam/acoustic-panel warmth replaces the purple-tinted obsidian | | Amber `#FF9F0A` stays primary | Record-light identity + existing glow shaders stay in tune | The one saturated color; used like a signal lamp, not decoration | | Mint `#2FD48C` accent | "Live levels" green from a mixing desk | Signals go/recorded/success — the second voice in the palette | | Violet `#8B5CF6` secondary | "Published" end-state | The far end of the guest journey (prospect → published) | | Radius softened to `4/8/12/16px` | Crafted scale by hierarchy | Removes the brittle 2px-everything template look | | Space Grotesk / DM Sans / JetBrains Mono | Display / UI / timecode | Geometric display + humanist UI + a true mono only where data is shaped like mono (timecodes, waveforms, file sizes) | ### Principles 1. **Amber is a signal, not a paint.** Reserve `--color-primary` for state (live, active, record, focus) and the primary action. One amber element per viewport zone. 2. **Surface hierarchy over shadows.** Layers = bg-primary → secondary → tertiary → elevated; borders do most of the work, shadows only lift. No stacked shadow cards. 3. **The waveform is the brand mark.** Live audio is the product's most characteristic object; every recording/clip surface should show amplitude, never a static image. 4. **The guest's journey is the information architecture.** Pipeline colors (`prospect → contacted → scheduled → recorded → published`) are one coherent spectrum each stage — a status color says where a guest is without words. 5. **Every page earns its entrance.** One orchestrated load moment per page (header reveal or grid stagger), interaction-driven motion everywhere else, `prefers-reduced-motion` always respected. 6. **Sentence case everywhere.** No all-caps eyebrow labels, no "WORD — fragment" constructions. Labels are lowercase-of-speech: "Studio settings", "Guest network". ### Anti-patterns (banned from this system) - Amber text gradients, amber glows on non-interactive elements, amber on amber. - Card grids where every cell is an identical rounded rectangle with the same shadow. - ALL-CAPS section eyebrows (the old `.section-title` treatment — use size/position instead). - Gradient washes as decoration; hero glow backgrounds must come from the product object (waveform, photo, studio imagery). - Numbered markers on non-sequences. --- ## 2. Foundations (tokens) Single source: `packages/design-tokens/src/index.ts` → emits `apps/web/src/styles/tokens.css` and Tamagui's config. Tailwind bridges via `@theme inline` in `apps/web/src/styles/globals.css` (`bg-canvas`, `text-ink-2`, `border-line`, `radius-edge`, `shadow-e1…e4`, `shadow-signal`, …). ### 2.1 Color — dark (default) | Token | Value | Role | |---|---|---| | `--color-primary` | `#FF9F0A` | Record light / primary action | | `--color-primary-light` | `#FFC568` | Hover sheen, light accent | | `--color-primary-dark` | `#D97E00` | Pressed state | | `--color-secondary` | `#8B5CF6` | Published end-state, premium | | `--color-accent` | `#2FD48C` | Live levels / go | | Semantic | `success #2FD48C · warning #F59E0B · error #F16063 · info #5B9DFF` | | | Guest pipeline | `prospect #5B9DFF · contacted #F59E0B · scheduled #FF9F0A · recorded #2FD48C · published #8B5CF6` | One journey, cool→warm→green→violet | | `--bg-primary` | `#100E0C` | Canvas | | `--bg-secondary` | `#191613` | Recessed zones (kanban lanes, wells) | | `--bg-tertiary` | `#242019` | Hover fills, icon plates | | `--bg-elevated` | `#1D1915` | Cards, panels, modals | | `--border-color` / `subtle` | `#2E2921` / `#211D18` | Structure lines | | `--text-primary/secondary/tertiary/inverse` | `#F8F3EC / #A69D8F / #6F665A / #171310` | Warm paper white → sand → under-desk | | Stone | `#EDE5DA · #F7F2EB · #CFC2B2` | Desk-panel warm stone (light accents, light theme) | **Neutral ramp (50→1000):** `#FAF7F2 #F5F0E9 #ECE5DA #DDD3C4 #C0B5A3 #A69D8F #8A8074 #6F665A #2E2921 #242019 #191613 #100E0C` — a single warm greige ramp; no cool grays anywhere. ### 2.2 Color — light (`[data-theme="light"]`) Morning desk paper: canvas `#FAF7F2`, well `#F2ECE2 tertiary #E9E1D4`, elevated `#FFFFFF`, borders `#DED3C2/#EDE5D8`, ink `#241D14/#6B6154/#948B7D`. Brand values do not change — amber holds contrast on paper thanks to `#D97E00` for text-on-light (`--color-primary-dark` is the read-safe amber on light surfaces). ### 2.3 Typography - **Display — Space Grotesk**: short lines tight (`letter-spacing -0.03em`, hero styles up to `clamp(3rem, 8vw, 6rem)`). One display voice across marketing, dashboard headers, stat values. - **UI — DM Sans**: body and chrome at `1rem/1.55`. - **Mono — JetBrains Mono**: only for timecodes (`00:12:34`), file sizes, waveform scales. Always `font-variant-numeric: tabular-nums` for any animated count. | Level | Font / size / weight | Use | |---|---|---| | Hero | display / `--text-hero` / 700 / `-0.04em` | Marketing hero only | | H1 | display / `--text-3xl` 2rem / 700 | Page title (dashboard) | | H2 | display / `--text-2xl` / 600 | Section | | H3 | display / `--text-lg` / 600 | Card title | | Body | sans / `--text-base` / 400 | Reading copy (≤ 75ch) | | UI | sans / `--text-sm` / 500–600 | Buttons, inputs, nav | | Meta | sans / `--text-xs` / 500 | Timestamps, counters | | Data | mono / `--text-sm` / 500 / tabular | Timecode, numbers in place | ### 2.4 Spacing, radius, elevation, motion - **Spacing**: unchanged 8-pt grid (`--space-1…24`). Dashboard content padding: 24px mobile / 32px desktop. - **Radius by hierarchy**: `sm 4px` chips · `md 8px` buttons, inputs, cards · `lg 12px` panels/modals · `xl 16px` hero surfaces · `full` avatars/dots/pills. **Do not** mix radii inside one component tree smaller than its parent by less than one step. - **Elevation**: `sm` resting · `md` hover · `lg` dropdowns/popovers · `xl` modals. `--shadow-glow` only on the record light and primary button focus. - **Motion ramp**: fast 120ms (hovers) · normal 220ms (state changes) · slow 350ms (modals). Springs `cubic-bezier(.34,1.56,.64,1)` for entrances. One page-load sequence (`.stagger-children`) per page — nothing else auto-animates. --- ## 3. Component specs (`packages/ui` + `apps/web/src/styles/globals.css`) Each spec = structure, states, and the class/alias to use. All consume tokens; never hardcode hex. | Component | Spec | Class alias | |---|---|---| | **Button** | 8px radius; primary = amber fill, ink-inverse text, hover raise `md`, press `scale(.97)`, glow only while recording context is active; secondary = 1px border, amber border+text on hover; ghost = tertiary fill on hover; destructive 40px min target, accent destructive is border+text only | `.btn`, `.btn-primary/secondary/ghost` | | **Input** | self-lined 1px, tertiary `md` at rest; focus ring expands, invisible border; placeholder `tertiary` label; mono for timecode inputs | `.input` | | **Card / panel** | secondary panel; radius `8px-lg 12px`, no resting shadow; hover shadow + 1px translate only on interactive; flat padding 16px, detail 24px | `.card`, `.frosted` | | **Status badge** | 10-tinted contrast background, 40px chip: `rgba(--status-color, 0.12)` fill, tinted text, border `rgba(0.2)`; dot variant for kanban lanes and calendars; pulse on change (`.status-badge-animate`) | `.status-badge`, `.status-*` | | **Stat card** | label (meta) → value (display, tabular) → delta (± mint/red); icon plate 40px tertiary + border; sparkline optional amber | `.stat-card` | | **Nav rail / links** | active = 3px amber left bar with scaleY lead-in, surface tint `amber 8%`, ink-primary text; hover = bar at 60% opacity | `.sidebar`, `.nav-link` | | **Topbar search** | ghost field with `⌘K` badge; focus hides kbd, becomes a live filter | `.topbar-search` | | **Kanban stage & card** | lanes `secondary` rail; amber ≤ header, cards have grey background tint; guest avatar (full), name (600), stage dot; hover: amber 35% border + `md` shadow lift; drag active `.guest-card-dragging` amber layout (`.drop-zone-active` pulse) | `.kanban-card` | | **Waveform / recording card** | gradient amplitude bar `tertiary → amber-highlight` intervals within card; play overlay iris circle (full radius) turns amber when in hover; timer mono-recording amber fades 1.2s in / 2s out | `.recording-card`, `.recording-active` | | **Modal / slide panel** | `xl` shadow on `secondary` bg, close/logout X, entrance mono 24ms, scaled-out `(.12→1)`, scale pop `spring`; panels navigate with accent; slide panel width 480 (100vw mobile) slideInRight | `.modal-overlay`, `.slide-panel` | | **Toast** | success entry `success-bounce`, border accent by intent, 4.5s dismiss, stacked bottom-right; error toasts must be actionable ("Retry", "Update mic settings") | `.toast-success-animate` | | **Empty state** | tertiary + ink-mid + cyan icon; primary action copy as decision point, not mood ("Add your first guest", not "No guests yet") | `.empty-state` | | **Skeleton** | textured gradient (journey), never more than 1-level; shimmer fully complete before spinner cycles (1.5s) | `.skeleton` | | **Dropdown / popover** | `primary` ink-point, radius `8px`, `lg` shadow; items 32px height, hover `tertiary`; `ESC` discard action row destructive = border style | radix | | **Keyboard hint** | mono chip `230ms spring`, 1px border-bottom, 2px translation on press | `kbd` | | **Tooltip** | fade+pop 4px, never wraps; shortcut forms | radix + `.tooltip-animate` | | **Progress / meters** | thin 4px amber fill structure always animates `progress-fill` on mount; all stats use `number-animate` | `.progress-bar-fill` | **Do-nots:** icon plates keep paddings symmetrical — no bottom-aligned text blocks; don't stack `card` inside `card` — use `--bg-secondary` wells for nested sections; don't use `full` radius for cards (avatars and dots only). --- ## 4. App architecture ### 4.1 Dashboard shell (all authenticated routes) ``` ┌─────────────┬──────────────────────────────────────────────┐ │ side nav │ topbar: search ⌘K · notion of workspace │ │ typed by │──────────────────────────────────────────────│ │ workspace. │ main: page-header · grid · panels │ │ amber bars │ consistent content max-width 1280, 32 pad │ └─────────────┴──────────────────────────────────────────────┘ ``` Sidebar sections (fixed order, this matches current IA): 1. **Overview** · Dashboard, Diary 2. **Talent** · Pipeline (podcasts/[id]/guests), Outreach, Guest network, Search 3. **Production** · Recording, Episodes, Content studio 4. **Business** · Wallet, Tickets, Billing 5. Bottom: Settings, Support, user profile Navigation maps status colors: item's *tab* shows one stage count with a stage dot. ### 4.2 Route map (every page covered below) | Group | Pages | |---|---| | Marketing | `/` landing · `/pricing` · `/about` · `/network` · `/security` · legal ×5 · `/tickets`, `/tickets/[eventId]` (+success/cancel/verify) · `/in/[vanityUrl]` | | Auth | `/login`, `/sign-in`, `/sign-up`, `/register`, `/forgot-password`, `/reset-password`, `/verify-email` | | Onboarding | `/onboarding` | | Dashboard | `/dashboard` · podcasts hub + `[id]` (record, green-room, stream, schedule, guests & detail/journey/technical-profile, episodes, recordings, content-studio, billing) · outreach · guest-network · search · chat · diary · wallet · settings (+profile/platform/billing) · support · ticketing | | Guest portal | `/join-network` · `/booking/[token]` · `/upload/[token]` · `/invoice/[id]` | --- ## 5. Page-by-page layouts Every page spec: **layout wireframe → components used → notable states → references**. References are live Dribbble shots (with search deep-links for browsing further). Keep a Pinterest board per section bookmarking these tags: "podcast dashboard", "crm kanban dark", "audio recording studio ui", "booking calendar dark", "dark saas landing", "auth flow dark". ### 5.1 Marketing — landing `/` ``` │ Γ studio control-room photo, dim → transparent to canvas │ │ (immersive header w/ glow-line at bottom) │ │ ────────────────────────────────────────────────────── │ │ show me a show: "Get your guests. Get the mic." │ │ waveform that plays on scroll — THE moment │ │ [Book guest] [See pricing] │ │ ┌ stat: 480 guests │ stat: 96% booked │ stat: 12 studios───┐ │ │ live demo panel: pipeline card the widget (product shot) │ │ How it works: 3 timed lanes (not numbered): prospect/ │ │ outreach / recording, each strip amber→violet │ │ Network wall: avatar collage → social proof │ │ Pricing summary + FAQ │ │ footer: warm dark-lead CTA panel, amber ONE action │ └───────────────────────────────────────────────────────────┘ ``` - Hero entrance: headline revealUp, waveform plays (`.animate-reveal`), ONE sequence. - Hero image is studio/gear photography darkened to canvas color — no flat gradient bg. - CTA hierarchy: single amber button; secondary as ghost. Announcement badge (info) allowed above headline. - References: [Dark SaaS landing collection](https://dribbble.com/search/dark-saas-landing-page), [NeuroPod dark AI podcast landing](https://dribbble.com/search/dark-saas-landing-page), [AI Platform hero — dark mode SaaS landing](https://dribbble.com/shots/27029789-AI-Platform-Hero-Section-Dark-Mode-SaaS-Landing-Page), warm-accent music-studio landing [The Online Recording Studio](https://dribbble.com/shots/27657088-The-Online-Recording-Studio-Music-Production-Reimagined), audio-studio landing [Sonos/MP3](https://dribbble.com/shots/27290479-Music-Production-App-Landing-Page-Audio-Studio-UI-UX-Design). ### 5.2 Marketing — `/pricing`, `/about`, `/network`, `/security`, legal pages - **Pricing**: 3 tiers, elevated panel cards with `xl` radius, featured tier marked with amber top-edge bar (not a bigger card); feature rows use mint checks. True comparison table below the fold on desktop. Ref: [dark gradient SaaS landing pricing pattern](https://dribbble.com/shots/26555044-Dark-Gradient-Responsive-SaaS-Landing-Page-Design). - **Network**: fresh guest search (name wall) — verified badges = mint; each guest row = avatar + credibility line + worked-on shows. Empty search shows curated featured guests, never blank. - **About**: left 60/40 photo/text, warm stone pull-quotes, small team grid (no cards, use borders). - **Security & legal**: 65ch single column, jump-link side index left-rail (no all-caps eyebrows); security: shield matrix of controls with mint pass states. ### 5.3 Marketing — ticketing (public) `/tickets`, `/tickets/[eventId]` (success / cancel / verify) - **Index**: event cards in 2-col grid — art (16:9, radius `lg`), date chip mono, venue + price; sold-out = charcoal + dashed border, no red. - **Detail**: hero art, sticky buy panel right 380px amber primary ("Get tickets"), tiers selector as radio-row; info as table-type rows. - **Success**: center panel, mint confirmation dot pulse + mono ticket code; QR block; "Add to calendar" ghost. - **Cancel**: calm copy, secondary button; verify ticket: single input OTP-style cells. - Refs: [Event App UI — ticket booking, dark](https://dribbble.com/search/booking-calendar-ui), [Booking Service Appointment dark dashboard](https://dribbble.com/search/booking-calendar-ui). ### 5.4 Auth group (`/sign-in`, `/login`, `/sign-up`, `/register`, `/forgot-password`, `/reset-password`, `/verify-email`) ``` ┌─────────────────────────┬─────────────────────────────────┐ │ form column 40% │ product visual 60% (desktop) │ │ brand mark │ live waveform + amber record │ │ h1: "Welcome back." │ light, dimmed studio photo bg │ │ [email] [password] │ the ONE hero object auth gets │ │ amber [Sign in] │ rotated test cards of pipeline │ │ ghost [Social...] │ (fades into canvas bottom) │ │ links row │ │ └─────────────────────────┴─────────────────────────────────┘ ``` - Visual column collapses below 900px; never break the form. - Error inline as `error` below field + button remains re-usable; disable not gray (keep amber, `--color-primary-dark` text). - Verify email/reset: single goal per screen; OTP cells mono `tabular-nums`. - Refs: [Modern Auth Flow — dark sign in/up](https://dribbble.com/shots/27299625-Modern-Auth-Flow-Sign-In-Sign-Up-UI), [Dark mobile auth set](https://dribbble.com/shots/26235477-Stock-X-Dark-Mode-Mobile-Auth-UI-Log-In-and-Sign-Up), [FinTech auth+OTP set](https://dribbble.com/shots/27318595-FinTech-Finance-App-UI-Design-Auth-Onboarding-Password-Rese). ### 5.5 Onboarding `/onboarding` - 3 steps, one per screen: 1 Workspace name & slug (lvh preview lives inline), 2 Podcast identity (name, cover upload w/ `xl` dropping zone), 3 Recording readiness (mic checks — mono meter). - Progress = segmented amber bar; every step has a visible "Skip for now" ghost at left of primary. - Continues the auth visual language; ambient radial amber light behind the form card only here. ### 5.6 Dashboard `/dashboard` ``` │ header: "Good {morning}, {name}" h2 + New guest (amber) │ │ ┌── stat row (4): booked-month · pipeline · recordings · │ │ │ wallet, each stat-card w/ tabular value + delta │ │ ├─ 58% quality: live pipeline preview (kanban 5 lanes, │ │ │ compact): drag -> full pipeline page │ │ ├─ recordings column: 3 recording-cards w/ waveform play │ │ └─ spotlight column: content studio file suggestions + │ │ guest network tiles (verified, warm) │ │ empty: 3 empty-state panels, each w/ ONE cta │ └──────────────────────────────────────────────────────────┘ ``` - The stat row uses 2×2 on tablet, stacked on mobile; values stagger-in once. - Refs: [Podcast Dashboard, dark](https://dribbble.com/shots/9699028-Podcast-Dashboard), [Podcast Dashboard design dark (Piqo)](https://dribbble.com/TimPanov/collections/2723669-Dashboards), [Modern SaaS dashboard, dark analytics](https://dribbble.com/shots/26904638-Modern-SaaS-Dashboard-UI-Dark-Analytics-Experience), [Dark admin dashboard data-focused](https://dribbble.com/shots/27059732-Dark-Admin-Dashboard-UI-Clean-Scalable-Data-Focused), [Dark vs light theme consistency](https://dribbble.com/shots/27600243-SaaS-Dashboard-UI-Dark-vs-Light-Mode). ### 5.7 Podcast hub `/podcasts` and podcast detail shell `/podcasts/[id]/*` - Hub: podcast cards (cover `xl` radius, name [display], next-episode line), one "New podcast" dashed tile. - Detail shell: podcast cover 56px round + cover, tabs in topbar area: `Pipeline · Schedule · Recording · Episodes · Content · Billing`; per active tab, right side shows contextual primary action (Invite guest / Open green room…). - **Pipeline (guests)**: 5-lane kanban (prospect→published), `.kanban-card` per guest; lanes count chip uses stage dot; preview panel (480px slide) shows journey stepper + next actions inline. Refs: [CRM pipeline — list & kanban](https://dribbble.com/shots/26350940-CRM-Pipeline-UI-Modern-List-Kanban-Views), [Deals Pipeline Kanban](https://dribbble.com/search/pipeline-crm), [Preview-panel pattern (QuickSuite)](https://dribbble.com/shots/27554738-SaaS-CRM-Lead-Pipeline-Dashboard-UI-Design-QuickSuite), [Dark kanban board](https://dribbble.com/shots/26321901-Dark-Mode-Kanban-Board-Designed-with-MadeinFigma), [Kanban+timeline+calendar tabs pattern](https://dribbble.com/shots/26697852-Task-Management-Web-App-UI-Kanban-Board-Timeline-Calendar). - **Guest detail**: hero block (avatar full, name h2, stage badge), left column 'Journey stepper' (vertical, mono timestamps at each transition), right column technical-profile card set (mic setup, streaming link, timezone) — each as key:value mono rows. - **Journey page ([guestId]/journey)**: horizontal stepper on desktop (stage dots connected by hairline, glowing current), vertical on mobile; each node opens correlated outreach/recording card on click. - **Schedule**: week-view grid (`--bg-secondary` canvas) with slot cards mint=scheduled, amber=pending; day/week/month switcher; drag to create; conflict = warm red border with hover explaining. Refs: [Calendar dashboard team scheduling](https://dribbble.com/shots/26512783-Calendar-Dashboard-UI-Smart-Team-Scheduling-Planner), [Schedule builder light/dark](https://dribbble.com/shots/27844814-Schedule-Builder-Light-Dark-UI), [Booking calendar UI](https://dribbble.com/shots/26273271-Booking-Calendar-UI-Design), [Recording Studio Booking Calendar](https://dribbble.com/search/booking-calendar). - **Record `/record` + `/record/green-room`**: full-bleed dark stage: participant tiles as cards on canvas, live timer in mono; green-room = join panel before stage (mic/cam check meters mint); live red-dot pulse + `recording-active` class; end-reveal summary stats. Refs: [Dark Mode Music Studio UI](https://dribbble.com/shots/26615537-Dark-Mode-Music-Studio-UI-Design), [Voice recorder UI component](https://dribbble.com/shots/27118782-Voice-Recorder-UI-Component), [Media player minimal dark](https://dribbble.com/shots/27362785-Media-Player-UI-Design). - **Recordings** (list + RecordingDashboard): master row (waveform thumb, duration mono, published date) + detail panel timeline clips scoring bars from clip-scorer (score tinted mint→amber, ≤80 amber "highlight" chip). Refs: [Audio player, podcast streaming UX](https://dribbble.com/shots/27230198-Audio-Player-Mobile-App-UI-Design-Clean-Podcast-Streaming-UX), [Streeem podcast audio player](https://dribbble.com/search/audio-recording-ui). - **Episodes**: table-first (row = cover 40px, title, duration, status badge, publish date); row click expands inline actions; bulk-select bar floats amber. - **Content studio**: split editor — left episode notes with `diary-note-input`; right live asset sidebar (waveform trims); autosave spinner replaced by mint check fade. - **Podcast billing**: invoice summary cards + plan row (Current plan highlighted amber edge); usage meter wraps `--space-*` tokens `UsageMeter`. ### 5.8 Outreach `/outreach` - Two-pane: sequence list left (name, steps count, enrolled count) · builder right: step cards vertical connectors; template messages preview in a device-width panel; tracking numbers either tabular stat row top. - Rate limits surfaced as usage-meter warning (amber) — never silently blocked. - Refs: [CRM dark dashboard (sequence view)](https://dribbble.com/shots/27378431-CRM-Dashboard-UI-Design-Dark-Theme-Sales-Deal-Management), [Pipeline CRM builder](https://dribbble.com/search/pipeline-crm). ### 5.9 Guest network `/guest-network` + `/search` - Filter rail left (segment chips with pipeline colors), masonry of guest-tiles; verified = mint dot; network-booking CTA ghost by default, amber after plan gating satisfied. - `/search`: topbar-search expanded to page: results grouped (Guests / Podcast / Show moments / Episodes) with gradient score chips; keyboard results nav (arrow row highlight `list-item-hover`). ### 5.10 Chat `/chat` + Diary `/diary` - Chat: canvas-stream column with bubbles left/right (mine `bg-tertiary`, theirs `bg-elevated`), presence dots pulse-mint; amber only for unread panel title divider. - Diary: full-screen `diary-flow-shell` panel with amber sparkles radial corners (existing pattern), textarea `bg-primary` writing surface, right column: daily prompts + mood chips; flow boards reactflow, amber map state border. `.diary-flow-shell` keeps its radial amber corners over the `bg-secondary` panel. ### 5.11 Wallet `/wallet` - Balance hero card amber→stone (gradient restricted to ONE hero surface), ledger row list below; pending rows slightly faded; top-up/release flow modal; invoice export ghost on rows. - Refs: [FinTech dashboards dark](https://dribbble.com/search/dark-saas-landing-page) + token-meter patterns from `UsageMeter`. ### 5.12 Settings `/settings` (`/profile`, `/platform`, `/billing`) - Left rail jump-links (uncanonicalized original), right column forms; destructive actions sit in an "Advanced→" open-border tertiary panel, border-tinted warning on toggle rows only. - Platform form uses toggle switches amber when on; tenant/tier state landed via `UpgradePrompt` patterns but warm. ### 5.13 Ticketing (workspace) `/ticketing`, `/ticketing/[eventId]`, `/ticketing/reports` - Staff-side mirror of public `/tickets`: same visuals + operations (orders table, check-in scanner panel with mono code input, mint pass state at once). Reports: bar/metric stat-card grists, export ghost. ### 5.14 Support `/support`, `/support/[ticketId]` - List: status dot + subject + age; detail: conversation as chat-like thread + resolution mint check; create-ticket form = inputs stack minimal, attach zone dashed drop-zone. ### 5.15 Guest portal (no-auth token pages) - `/booking/[token]`: proposal-consultation card: episode title, dial-in big mono time, accept [amber] / suggest times inline list; confirm → mint confirmation panel. - `/upload/[token]`: drop-zone-active full-panel with clip upload + waveform-styled holder, mint progress conversion flows; error states with retry. - `/invoice/[id]`: paper-styled panel (bg `stone-light`), mono totals — the only surface that intentionally looks like a document. - `/join-network`: single signup card + benefit stack list, verified mint signal again. - `/in/[vanityUrl]` (host public): cover art + Spotify/Apple/YouTube links as ghost rows + "Book this podcast" amber. --- ## 6. Responsive, accessibility, and quality floor - **Breakpoints**: 480 / 768 / 1024 / 1280. Sidebar → off-canvas overlay under 768 (`sidebar-mobile-overlay`, hamburger). Kanban lanes collapse to stacked under 768. Stats 4→2→1. Slide panels → full-viewport sheets. - **A11y**: focus-visible amber ring on everything interactive (token-driven); `sr-only` for icon-only buttons; every stage/label carries a text alternative without relying on color alone (dots always pair with words); contrast: amber on canvas ≥ 4.5:1 for text-sizes ≥ `sm` at 600 weight; waveforms never the only signal (caption time text). - **Reduced motion**: all `@keyframes` collapses handled in `globals.css` (already wired). - **Empty/failure**: every list has an empty-state with ONE action; error states name the fix in-platform voice ("Microphone blocked — allow access in your browser settings"), notes spoken in user's language not system logs. - **Performance floor**: waveforms ≥ 60fps canvas sampling; hero imagery ≤ 200KB `next/image`; no layout shift on font load (`display: swap` stays). --- ## 7. Reference index (Dribbble boards to keep hot) | Area | Primary references | |---|---| | Dashboards | [Podcast Dashboard dark](https://dribbble.com/shots/9699028-Podcast-Dashboard) · [Dashboards collection (Tim Panov)](https://dribbble.com/TimPanov/collections/2723669-Dashboards) · [Podcast glass UI](https://dribbble.com/shots/17820442-Podcast-Dashboard-Design-Glass-UI) · [Dark glassmorphism sidebar](https://dribbble.com/shots/27464830-Dark-Glassmorphism-Dashboard-UI-Modern-Sidebar-Navigation) · [SaaS analytics dark](https://dribbble.com/shots/26904638-Modern-SaaS-Dashboard-UI-Dark-Analytics-Experience) · [Clean data admin](https://dribbble.com/shots/27059732-Dark-Admin-Dashboard-UI-Clean-Scalable-Data-Focused) · [ShadCN CRM minimal](https://dribbble.com/shots/26064719-A-Clean-CRM-Dashboard-Built-with-ShadCN-UI-Where-Minimal-Meets) | | Pipeline / kanban | [List & kanban CRM](https://dribbble.com/shots/26350940-CRM-Pipeline-UI-Modern-List-Kanban-Views) · [Sales pipeline, modern CRM](https://dribbble.com/shots/26250870-Sales-Pipeline-Dashboard-Modern-CRM-UI) · [DealFlow pipeline](https://dribbble.com/search/pipeline-crm) · [Preview-panel QuickSuite](https://dribbble.com/shots/27554738-SaaS-CRM-Lead-Pipeline-Dashboard-UI-Design-QuickSuite) · [Dark kanban](https://dribbble.com/shots/26321901-Dark-Mode-Kanban-Board-Designed-with-MadeinFigma) · [Kanban/timeline/calendar app](https://dribbble.com/shots/26697852-Task-Management-Web-App-UI-Kanban-Board-Timeline-Calendar) | | Recording / audio | [Dark music studio UI](https://dribbble.com/shots/26615537-Dark-Mode-Music-Studio-UI-Design) · [Online recording studio (warm amber)](https://dribbble.com/shots/27657088-The-Online-Recording-Studio-Music-Production-Reimagined) · [Audio player podcast UX](https://dribbble.com/shots/27230198-Audio-Player-Mobile-App-UI-Design-Clean-Podcast-Streaming-UX) · [Voice recorder component](https://dribbble.com/shots/27118782-Voice-Recorder-UI-Component) · [Media player dark](https://dribbble.com/shots/27362785-Media-Player-UI-Design) · [Search: audio recording UI](https://dribbble.com/search/audio-recording-ui) | | Scheduling / booking | [Calendar team scheduling](https://dribbble.com/shots/26512783-Calendar-Dashboard-UI-Smart-Team-Scheduling-Planner) · [Schedule builder light/dark](https://dribbble.com/shots/27844814-Schedule-Builder-Light-Dark-UI) · [Booking calendar](https://dribbble.com/shots/26273271-Booking-Calendar-UI-Design) · [Search: booking calendar](https://dribbble.com/search/booking-calendar) · [Recording studio booking calendar](https://dribbble.com/search/booking-calendar) | | Landing / marketing | [Search: dark SaaS landing](https://dribbble.com/search/dark-saas-landing-page) · [AI platform hero dark](https://dribbble.com/shots/27029789-AI-Platform-Hero-Section-Dark-Mode-SaaS-Landing-Page) · [Sonos music landing](https://dribbble.com/shots/27290479-Music-Production-App-Landing-Page-Audio-Studio-UI-UX-Design) · [Online recording studio](https://dribbble.com/shots/27657088-The-Online-Recording-Studio-Music-Production-Reimagined) · [Dark gradient responsive landing](https://dribbble.com/shots/26555044-Dark-Gradient-Responsive-SaaS-Landing-Page-Design) | | Auth / onboarding | [Modern auth flow](https://dribbble.com/shots/27299625-Modern-Auth-Flow-Sign-In-Sign-Up-UI) · [Dark mobile auth](https://dribbble.com/shots/26235477-Stock-X-Dark-Mode-Mobile-Auth-UI-Log-In-and-Sign-Up) · [FinTech auth + OTP](https://dribbble.com/shots/27318595-FinTech-Finance-App-UI-Design-Auth-Onboarding-Password-Rese) · [Neon wallet splash/login](https://dribbble.com/shots/26535013-Crypto-Wallet-App-Login-Signup-Screens-Dark-Neon-UI) | > **Pinterest sync habit:** create one board per row above (names: `MP·dashboards`, `MP·pipeline`, `MP·studio`, `MP·schedule`, `MP·landing`, `MP·auth`). Save everything from the deep-links, then grow each board only with shots that match the token table in §2 — a reference counts only if its palette and layout could map 1:1 to tokens; drop anything that would force a new token. This keeps the board useful inside this system instead of drifting. Pinterest's API doesn't allow automated board scraping, so boards are curated manually; Dribbble deep links above are the durable machine-readable index. --- ## 8. Rollout plan (smallest-complete-first) 1. **Done** — token upgrade (§2) propagates: warm surfaces, soft radii, warmer semantic/error colors, mint accent. Zero component rewrites needed (all styles are var-driven). 2. Sweep hardcoded stale values in `globals.css` where amber rgba now mismatches after any future primary change (none today — primary hue preserved by design). 3. Apply page-shape changes per §5 where they differ from today (landing hero object, auth split layout, pipeline preview panel, schedule week grid) — one page-group at a time via the class aliases above. 4. `packages/ui` primitives get token aliases for Tamagui spacing so mobile matches exactly. 5. Living checklist: every new screen PR must answer: does it use only tokens? one amber element per zone? one entrance animation? empty state with an action?