Files
musyz-mobile/.impeccable/critique/2026-10-17T12-56-43Z__app-src-main-java-it-panov-musyx-tv-ui.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

56 lines
4.4 KiB
Markdown

---
target: whole TV app UI
total_score: 26
max_score: 40
na_heuristics:
p0_count: 1
p1_count: 3
target_identity: "file:/Users/yp/Projects/musyx-mobile/app/src/main/java/it/panov/musyx/tv/ui"
timestamp: 2026-10-17T12-56-43Z
slug: app-src-main-java-it-panov-musyx-tv-ui
---
Method: design review only (detector not applicable, native platform). Evidence: Android TV emulator (sdk_google_atv64_arm64, 1080p), app build 0.1.1, Light and Dark themes, Small font size.
## Design Health Score
| # | Heuristic | Score | Key Issue |
|---|-----------|-------|-----------|
| 1 | Visibility of System Status | 2 | Focus is invisible on selected chips (amber ring on amber fill); playing station card not marked; rail shows no location on Now Playing |
| 2 | Match System / Real World | 3 | Podcast episodes say "Unknown artist"; podcast menu offers "Play similar tracks" |
| 3 | User Control and Freedom | 2 | Search field traps the D-pad: only Back leaves the page |
| 4 | Consistency and Standards | 2 | Seek fill is fg on Now Playing, accent elsewhere; three focus styles; podcast pages light Home in the rail |
| 5 | Error Prevention | 3 | Dislike sits directly beside Like on Now Playing |
| 6 | Recognition Rather Than Recall | 3 | Hold-select for menus documented only in README |
| 7 | Flexibility and Efficiency | 3 | Media keys, Play/Shuffle, long-press menus; three focus stops per track row slow vertical travel |
| 8 | Aesthetic and Minimalist Design | 3 | Dark theme is authored; Now Playing leaves a large void; Home is a long vertical stack |
| 9 | Error Recovery | 3 | Load failures offer retry |
| 10 | Help and Documentation | 2 | No in-app hint for hold-select or keyboard use |
| **Total** | | **26/40** | **Acceptable** |
## Design Specificity Verdict
LLM: Dark theme is authored (aubergine graphite, amber VU accent, Unbounded display, animated wave hero). Light theme loses that and reads as a generic lavender-white settings app, and it is the active setting. Layout grammar is ported from desktop (track table with album column, per-row heart and ellipsis, small Now Playing cover) rather than built for the 10-foot screen.
Deterministic scan: not applicable (native platform).
## Priority Issues
1. [P0] Search field traps D-pad focus and opens the IME on focus. Genres unreachable, rail unreachable, Back is the only exit. Fix: TextInput becomes a focusable surface; Select enters edit mode and shows keyboard; Up/Down/Left leave via focusManager when not editing. Same component on sign-in token field. Command: harden.
2. [P1] Focus ring invisible on selected/accent controls (Chip focusedContainer=accent + amber ring). Fix: one focus treatment: scale + 3dp fg ring with 2dp bg gap, never amber on amber; entering a chip row lands on the selected chip. Command: polish.
3. [P1] Track rows split into three focus stops; Down from hero lands on the heart column; focused row ring overlaps heart. Fix: row is the single vertical stop (focusGroup + onEnter to row), Right reaches heart/more. Command: layout.
4. [P1] Now Playing underuses the TV: 180dp cover, 20-scale title, empty middle-left, seek fill fg not accent, shuffle-off looks disabled. Fix: 360-420dp cover, displayM title, blurred cover backdrop, transport under meta, accent fill, distinct off state. Command: layout / bolder.
5. [P2] Home is a long vertical stack (10 recently played rows, 5 chart rows) before shelves. Fix: Recently played and Chart as card shelves; My Wave hero compact. Command: layout.
## Persona Red Flags
Alex: three stops per row; tabs need Select; Up into chip rows lands on first chip.
Jordan: Search keyboard pops over Browse and D-pad won't leave; collapsed rail is icon-only with a lone dot for brand; hold-select undiscoverable.
Sam: invisible focus on selected chips and the selected Light/Small/English chips; Mix genre card white on light gray.
## Minor Observations
Podcast episodes "Unknown artist"; menu "Go to album" on album page; "Play similar" for podcasts; 7 menu items. Heart badge overlaps cover typography on podcast cards. Detail heart floats alone under title. Drawer focus landed on My Wave while Home was current. "Show all 100" doesn't read as a control. Active station card not marked. Settings version line showed 0.1.1.
## Questions to Consider
What if Now Playing were the screen saver's calmer sibling: full-bleed art, controls on demand? Should Light exist on a TV at all? Does a 10-foot track list need an album column?