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>
This commit is contained in:
1 parent
a7079adb3b
commit
350b387723
29 files changed
+1152
-338
No files matched your search
@@ -0,0 +1,55 @@
|
||||
---
|
||||
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?
|
||||
@@ -0,0 +1,39 @@
|
||||
---
|
||||
target: whole TV app UI (after fixes)
|
||||
total_score: 29
|
||||
max_score: 40
|
||||
na_heuristics:
|
||||
p0_count: 0
|
||||
p1_count: 0
|
||||
target_identity: "file:/Users/yp/Projects/musyx-mobile/app/src/main/java/it/panov/musyx/tv/ui"
|
||||
timestamp: 2026-10-17T13-22-38Z
|
||||
slug: app-src-main-java-it-panov-musyx-tv-ui
|
||||
---
|
||||
Method: design review only (detector not applicable, native platform). Evidence: Android TV emulator 1080p, uncommitted build after the first critique's fixes, Light theme, Small font; Now Playing from earlier in the session on the same layout code.
|
||||
|
||||
## Design Health Score
|
||||
|
||||
| # | Heuristic | Score | Key Issue |
|
||||
|---|-----------|-------|-----------|
|
||||
| 1 | Visibility of System Status | 3 | Focus visible everywhere; no location on Now Playing; playing station/card unmarked |
|
||||
| 2 | Match System / Real World | 3 | Books and podcasts get music actions |
|
||||
| 3 | User Control and Freedom | 3 | Search trap fixed; Back closes the panel |
|
||||
| 4 | Consistency and Standards | 3 | One focus style; podcast pages light Home; desktop palette not updated |
|
||||
| 5 | Error Prevention | 3 | Dislike moved into the menu |
|
||||
| 6 | Recognition Rather Than Recall | 3 | Every row has a menu button |
|
||||
| 7 | Flexibility and Efficiency | 3 | One stop per row; tabs still need Select |
|
||||
| 8 | Aesthetic and Minimalist Design | 3 | Detail pages open with the title cut off; heart badges clutter covers |
|
||||
| 9 | Error Recovery | 3 | Failed loads offer a retry |
|
||||
| 10 | Help and Documentation | 2 | Nothing in the app explains how to use it |
|
||||
| **Total** | | **29/40** | **Good** |
|
||||
|
||||
## Priority Issues
|
||||
|
||||
1. [P2] Detail pages open with the header clipped (entry focus on Play scrolls the list). Fix: pin to top on first focus or keep the header in view. layout.
|
||||
2. [P2] Books and podcasts treated as music: 8-item menu with "Play similar tracks", "Go to album" on its own page, "Don't recommend"; "Unknown artist" on episodes; rail lights Home; audiobook labelled Podcast. clarify.
|
||||
3. [P2] Now Playing: no section lit in the side menu; Left from the open panel opens the side menu over it. polish.
|
||||
4. [P3] Redundant hearts in Liked tracks and on the Podcasts "Yours" covers; no playing marker on shelf or station tiles. polish.
|
||||
|
||||
## Minor Observations
|
||||
|
||||
Down from an empty search field lands on the third genre; collapsed menu shows a lone dot; desktop theme.rs still has the old light palette; ThemeTest.fontSizeScalesType is stale.
|
||||
@@ -0,0 +1,39 @@
|
||||
---
|
||||
target: whole TV app UI (round 3)
|
||||
total_score: 30
|
||||
max_score: 40
|
||||
na_heuristics:
|
||||
p0_count: 0
|
||||
p1_count: 0
|
||||
target_identity: "file:/Users/yp/Projects/musyx-mobile/app/src/main/java/it/panov/musyx/tv/ui"
|
||||
timestamp: 2026-10-17T13-42-52Z
|
||||
slug: app-src-main-java-it-panov-musyx-tv-ui
|
||||
---
|
||||
Method: design review only (detector not applicable, native platform). Evidence: Android TV emulator 1080p, uncommitted build after both rounds of fixes, Light theme, Small font. New this run: search results, artist page, Browse.
|
||||
|
||||
## Design Health Score
|
||||
|
||||
| # | Heuristic | Score | Key Issue |
|
||||
|---|-----------|-------|-----------|
|
||||
| 1 | Visibility of System Status | 3 | Playing markers and section lighting in place; loading is still plain text |
|
||||
| 2 | Match System / Real World | 4 | Books, podcasts and music each speak their own language now |
|
||||
| 3 | User Control and Freedom | 3 | Back and Left exits work everywhere; no undo for likes |
|
||||
| 4 | Consistency and Standards | 3 | "Show all" is a tile on Home but bare text in Search; rows entered at the wrong card |
|
||||
| 5 | Error Prevention | 3 | Dislike out of reach of the heart |
|
||||
| 6 | Recognition Rather Than Recall | 3 | Search "Show all" hard to find with the D-pad |
|
||||
| 7 | Flexibility and Efficiency | 3 | One stop per row, shelves, tabs counts |
|
||||
| 8 | Aesthetic and Minimalist Design | 3 | Browse page sparse with stacked headings; artist rows repeat the artist |
|
||||
| 9 | Error Recovery | 3 | Retry on failures |
|
||||
| 10 | Help and Documentation | 2 | No in-app guidance |
|
||||
| **Total** | | **30/40** | **Good** |
|
||||
|
||||
## Priority Issues
|
||||
|
||||
1. [P2] Entering a horizontal row from above lands on the card under the previous focus, not the first (Genres from the search field: Rock; artist Albums from the last track: second album). polish.
|
||||
2. [P2] Search results' "Show all" is bare text that Down skips; Home uses an end tile. polish.
|
||||
3. [P3] Browse: "Browse" title and "Genres" heading stacked over one row on an empty screen. layout.
|
||||
4. [P3] Artist page rows repeat the artist's name on every row. distill.
|
||||
|
||||
## Minor Observations
|
||||
|
||||
Collapsed menu shows only the brand dot; ThemeTest.fontSizeScalesType stale; desktop light palette not updated; nothing committed.
|
||||
Reference in new issue
Block a user