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

4.4 KiB
Raw Blame History

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 -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.