Tier 2Tier 2 · tvOS: tokens only. Search is a tab, and typing happens on the system's linear keyboard: a single alphabet row the focus engine sweeps across, drawn and owned by tvOS (UISearchController). put.io supplies tint, surfaces, type and the yellow file icons.--yellow-solid · --app-bg · --component-bg-active · --radius-tv
Native tvOS direction. The product behaviour is shared across TV tiers; the presentation follows Apple's system search controls and the token graph.
The system keyboard is the screen
tvOS search puts the linear keyboard at the top: one A-to-Z row plus space and delete, swept by the focus engine. The focused character is the system's light pill with its lift. put.io draws none of it.
Recent keywords surface as the system's search suggestions under the keyboard, fed from the same /config/search_history store every tier reads. Results are the standard tvOS rows: raw filenames, yellow glyphs, watched eye.
Files Activity Account
e
SPACEDELETE
ABCDEFGHIJKLMNOPQRSTUVWXYZ
3 results
homework_answers_DONT_DELETE
12 items
The.Wire.S03E04.Back.Burners.1080p.BluRay.x264-DEMAND.mkv
3.42 GB · 2 May 2026
Seinfeld.S09E23.The.Finale.Part.2.720p.HDTV.x264-FLEET.mkv
1.20 GB · 2 May 2026
Search · result focusedThe result row is the single focused target. When focus returns to the keyboard, tvOS supplies its light pill and lift.
entrySearch is a tab in the TabView, never a header button
keyboardsystem linear keyboard via UISearchController. Dictation and iPhone remote-keyboard input come free and must not be blocked
querykeyword echoed at 56 medium, centred, above the keyboard
historyrecent keywords as system search suggestions, from /config/search_history. Cleared from Account, as on every tier
resultsstandard tvOS rows under a N results caption: raw filename, size-and-date subline, folder chevron, watched eye
emptyContentUnavailableView.search with the keyword. Not a custom layout
Contract: platforms/apple/DESIGN.md
Do not draw a grid keyboard, restyle the linear one, or put a Search button in a header. The keyboard, its focus, dictation and the suggestion row are all UISearchController's; replacing any of them breaks the Siri Remote's swipe-typing.