Files
musyz-mobile/DESIGN.md
T
yuriy.pandClaude Opus 5.5 ac8358f302 Light theme: porcelain greys with a petrol accent
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>
2026-10-18 00:28:55 +06:00

80 lines
4.4 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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.