Files
musyz-mobile/DESIGN.md
T
yuriy.pandClaude Opus 5.5 350b387723 Redesign the TV interface for the remote and the room
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>
2026-10-18 00:14:39 +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

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.