The warm-paper light theme gives way to cool neutral greys (white panels on a porcelain ground, near-black ink) with a petrol accent, a muted blue-green that belongs on cool grey the way amber does on aubergine. The dark theme keeps its amber. Every text colour still passes 4.5:1 on bg, panel and raised, and the avatar initial now uses accent ink. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
4.4 KiB
Musyx design system
The approved mockup is 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 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-fillvariants 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
fgwhile focused, and everything on them (title, meta, icons, the playing accent) turns tobg. 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
raisedfill 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.