Navigation and focus: - The search field no longer traps the D-pad or opens the keyboard on focus; Select starts editing, and up and down always leave. - Focus is ink instead of an outline: rows, buttons, chips, tabs and the drawer fill with the text colour; covers and tiles lift with a soft shadow (a light one in the dark theme). Selected chips carry a check. - Track lists are one stop per row; right reaches the heart and menu, and left from a row always opens the drawer. - Chip rows and tab bars land on the selected item; card rows and the genre grid return to the card last visited. - Pages scroll only as far as focus needs, so headers stay in view. - The drawer lights the section a page was reached from. Screens: - Now Playing is a stage: a large cover over a blurred copy of itself, display-size title, album and year, amber progress, and the queue and lyrics in a panel that slides in on request (Back or Left closes it). - Home shows Recently played and the Chart as shelves, the chart ending in a Show all tile; search results end their tracks with Show all. - Browse is a genre grid under one title. Artist pages put the album, not the artist, under each track; album, artist and playlist pages put the heart beside Play. - Books and podcast episodes get their own menu (no similar tracks, dislike or "go to" the page you're on), no "Unknown artist", and books are labelled as books. - Playing tracks, albums and stations carry an equaliser badge; hearts are hidden where every item is liked. Theme: - Light is warm paper with aubergine ink and a deeper amber; every text colour passes 4.5:1. DESIGN.md records the palette and the focus rules. ThemeTest now checks the current font scales. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
79 lines
4.4 KiB
Markdown
79 lines
4.4 KiB
Markdown
# 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
|
||
|
||
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 warm paper
|
||
with aubergine ink: the same character in daylight rather than an inverted dark theme, with
|
||
the amber taken deeper so it reads as text on paper (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` | `#F4EEE4` | Window and content background |
|
||
| `panel` | `#23202B` | `#FBF7F0` | Sidebar, player bar, drawer, cards that need separation |
|
||
| `raised` | `#2D2937` | `#EAE2D4` | Hover and selected rows, chip fills, progress track |
|
||
| `line` | `#3A3546` | `#DCD2C1` | 1px dividers and outlines |
|
||
| `fg` | `#EEEAF3` | `#231C2B` | Primary text, the play/pause disc |
|
||
| `muted` | `#A39CB0` | `#62586A` | Secondary text, idle icons |
|
||
| `accent` | `#F0B23E` | `#8E5A04` | Current track, progress fill, primary buttons, active nav icon |
|
||
| `accent_ink` | `#2A1D04` | `#FFF7E6` | 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` + amber 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 amber) turns to `bg`. Amber 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 amber 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 amber.
|
||
- **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.
|