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

79 lines
4.4 KiB
Markdown
Raw 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
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.