# Musyx design system The approved mockup is [`design/mockup.html`](design/mockup.html) (published at https://claude.ai/artifact/2gmswtceJM61fcE2F5uYYM). This file records its tokens. They map 1:1 to the Compose theme (`app/src/main/java/it/panov/musyx/tv/ui/theme/Theme.kt`) and to the desktop app's `crates/musyx/src/ui/theme.rs` in the [musyx](../musyx) repo, so change all of them together. ## Direction In the dark theme the ground is aubergine graphite, with one amber accent taken from a tape deck's VU needle. The app is dark-first, and the light theme follows the system setting. Light is porcelain: cool neutral greys and near-black ink, with a petrol accent (a muted blue-green) in place of the amber, which reads warm and muddy on cool grey (every text colour passes 4.5:1 on `bg`, `panel` and `raised`). Everything stays quiet except the My Wave hero, which is the one animated, accent-heavy surface. ## Colour | Token | Dark | Light | Used for | |--------------|-----------|-----------|----------| | `bg` | `#1C1A22` | `#F1F2F5` | Window and content background | | `panel` | `#23202B` | `#FFFFFF` | Sidebar, player bar, drawer, cards that need separation | | `raised` | `#2D2937` | `#E5E7EC` | Hover and selected rows, chip fills, progress track | | `line` | `#3A3546` | `#D5D8DF` | 1px dividers and outlines | | `fg` | `#EEEAF3` | `#1B1C22` | Primary text, the play/pause disc | | `muted` | `#A39CB0` | `#5C606C` | Secondary text, idle icons | | `accent` | `#F0B23E` | `#1F5F7A` | Current track, progress fill, primary buttons, active nav icon | | `accent_ink` | `#2A1D04` | `#F2F8FA` | Text and icons on `accent` | | `like` | `#F27286` | `#B5304B` | Filled heart, falling chart position | | `ok` | `#7FCB9B` | `#24704A` | Subscription status, rising chart position | Covers that have no artwork yet get a placeholder made of two hues (`h1`, `h2`) derived from the item id, painted as a diagonal gradient between them. ## Type | Role | Face | Size / weight | Where | |---------|----------------------|--------------------|-------| | Display | Unbounded SemiBold | 46 / 40 / 34 / 30 | My Wave hero, detail page titles, sign-in headline, screen titles | | Wordmark| Unbounded SemiBold | 20 | `musyx` + accent dot | | Section | Onest SemiBold | 19 | Section headings ("Made for you") | | Body | Onest Regular/Medium | 14 (rows 14, meta 13, small 12.5) | Everything else | The fonts are bundled from `assets/fonts` and licensed under OFL. Durations and counts use tabular figures. ## Space and shape - Spacing steps: 2 · 4 · 6 · 8 · 10 · 12 · 14 · 18 · 22 · 28 · 34. Content gutter is 28, and the gap between sections is 34. - Radii: cover 10 · control 8 · small cover 6 · pill/round 999 · hero 16 · window cards 14. - Shell: sidebar 232 · player bar 80 · drawer 320 · track row 52 tall. - Icons: Lucide 0.460 (ISC), 18px and tinted via `currentColor`. The `-fill` variants are for liked, play and pause. ## Focus (TV) There's no hover on a TV, and no outline around focus either. Two treatments, nothing else: - **Ink**: rows, buttons, chips, tabs and drawer items fill with `fg` while focused, and everything on them (title, meta, icons, the playing accent) turns to `bg`. Accent buttons and the selected chip keep their fill. A selected chip also carries a check, so the choice still shows while focus is on it. - **Lift**: covers, cards and coloured tiles keep their own colours, grow 6–10% and cast a soft shadow below them: black in light, a light shadow in dark, where black disappears. ## Components - **Sidebar**: wordmark, five nav items (Home, My Wave, Search, Collection, Podcasts), a playlist list, and an account chip with sign-out. The active item sits on a `raised` fill and has an accent icon. - **Player bar**: shows cover, title/artist, like and dislike on the left. The centre has transport (shuffle, previous, play disc, next, repeat) over a progress bar with times. On the right are a quality badge, lyrics, queue and a volume bar. - **Track row**: index (or an equaliser when playing), cover, title/artist, album, like, duration and a "more" button that appears on hover. The playing row is in the accent. - **Cards**: a cover with a hover play button, the title, and one muted subtitle line. - **Drawer**: Queue | Lyrics tabs, sliding in from the right over the content edge.