MicProtocol / docs /design-system.md
Benaah's picture
Upload folder using huggingface_hub
b17baae verified
|
Raw History Blame Contribute Delete
34.5 kB

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        β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

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.
  • 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, Booking Service Appointment dark dashboard.

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              β”‚                                 β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

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                β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

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, Deals Pipeline Kanban, Preview-panel pattern (QuickSuite), Dark kanban board, Kanban+timeline+calendar tabs pattern.
  • 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, Schedule builder light/dark, Booking calendar UI, Recording Studio 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, Voice recorder UI component, Media player minimal dark.
  • 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, Streeem podcast audio player.
  • 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), Pipeline CRM builder.

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 + 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)

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?