style: resize Apple TV posters, landscape cards and cast photos

Merged
BL
21m ago
+74-52

Problem and reproduction

Apple TV cards felt a size too big from the couch, and fewer fit across a row than I want.
Home posters were 240 by 360, Continue Watching and other landscape cards 432 by 240, grids six across at 260 by 390, detail-page episode stills 480 by 270 (or 576 by 324, depending on a synced size setting that no longer has any UI), and Cast & Crew photos 240 by 360.

Implementation and impact

Apple TV only. iPhone and iPad sizes are unchanged.

  • Home rows and the rails that match them (Collections row, More Like This, collection rails, Studios & Networks rails, other-profile Search rows, Calendar's Trending rails) now show 220 by 330 posters. densePosterCardWidth is now derived from an on-screen railPosterWidth divided by Home's Large scale, so the maths stays in one place.
  • Continue Watching, Next Up, Home episode rows and library cards are 400 by 222 (same 1.8 shape as before). Sizes are rounded to whole points so the card and Home's artwork warm-up ask for the same decode size.
  • Poster grids go from six to seven across, about 217 by 326: Search and its Seerr results, library pages, collection pages, Studios & Networks pages (including the hand-built first row), the Collections tab and Calendar's day view. A person's filmography now uses the same fixed seven-column grid instead of a size that depended on the synced setting.
  • The detail-page episode rail is a fixed 400 by 225, the same as the series page's episode shelf, and no longer follows the synced size. TVDetailLowerBackground now lines up with that height (it used an unrelated token before).
  • Cast & Crew photos are 180 by 270, and the name now sits 24 points under the photo (was 12) so the focus lift doesn't cover it.
  • Seerr's status ribbon can shrink to 80% on Apple TV so longer labels like "Needs attention" fit the narrower grid poster instead of cutting off.
  • Deliberately unchanged: caption text sizes, gaps between cards, the person page header portrait (pinned at 200 by 300), the hero poster, trailers, the series episode shelf and the library arrange grid.
  • Focus and edges: rows keep the continuous scrolling and scroll-margin gutters from #319, and every grid's right column still ends 80 points from the edge, so the lifted card stays on screen. Smaller cards leave more room for the lift than before.

Validation

  • xcodebuild build -scheme VividTV for the Apple TV 4K (3rd generation) simulator, tvOS 27.0, with local ad hoc signing: succeeded at 9ae6aa3e.
  • Two read-only regression reviews of the diff traced every surface to its on-screen size and checked focus clipping, right-edge behaviour, reserved row heights, the seven-column grid maths and decode sizes. They found the warm-up rounding mismatch and the Seerr ribbon truncation, both fixed here.
  • CI hasn't run yet.

Performance

No benchmarks run. Grid posters are smaller, so eight decoded rows of seven-across posters hold fewer pixels than eight rows of six-across 260-point ones did.

Testing status

  • Tested? Partly.
  • Environment: Apple TV 4K (3rd generation) simulator, tvOS 27.0.
  • Revision: 9ae6aa3e.
  • Checks and results: On Home, Continue Watching cards measured 400 wide, posters 220 wide with 40-point gaps. On a movie page, Cast & Crew photos measured 180 wide, and I checked that a focused photo no longer covers the actor's name.
  • Limitations: Grids, Search, Calendar, Studios & Networks pages and the episode rail weren't measured on the simulator, only traced in code. Not tested on a physical Apple TV.

Design impact and approval

  • Design impact: Apple TV card sizes and grid column counts change as listed above. Text sizes and spacing are unchanged.
  • Approval from blurbery: My own change, decided in my working session on 18 November 2026 (seven-across grids chosen there too).

Documentation impact

Updated README.md (Search now seven across), docs/app-design.md (grid, rail, filmography and Cast & Crew sizes, and the iPhone Duo grid line no longer says "like Apple TV") and docs/apple-tv-browsing.md (Home, landscape, episode rail, catalogue grid, library page, Calendar, Search, Seerr and person portrait sizes).

  • I checked the docs this change affects and updated them in this PR, or explained above why none needed changes.

AI disclosure

I implemented these changes and used Claude Opus as a tool.