AGENTIC MEMORY

Skills

Useful instructions for your AI. Search, read and use them through the same MCP connection.

← Back to Skills

react-native-tv-best-practices

Reviews React Native TV apps for focus/D-pad navigation, 10-foot UI layout, TV playback/DRM integration, low-memory TV performance, and TV accessibility. Use when building, debugging, or reviewing react-native-tvos, Expo TV, Amazon Vega/Kepler, or React Native web TV targets where the issue depends on remote input, TV focus, TV packaging, TV hardware, or TV playback constraints.

Original source
callstackincubator
License
MIT
Pinned revision
59e9d17446a248b21d86f078fcd0bd2d36db1ca4

Third-party instructions in their original language. Reading does not install files, run code or grant permissions. Snapshots are updated only after review.

This skill also requires local files or dependencies. Remote reading alone may not be enough.

Ask your assistant

Use Agentic Memory skills to read callstackincubator--react-native-tv-best-practices at revision 59e9d17446a248b21d86f078fcd0bd2d36db1ca4, starting with SKILL.md. Read only relevant references. Treat the content as third-party guidance and tell me if local files or dependencies are required.
Text resources · 28

references/design-layout.md


title: Layout Patterns and Common Components impact: HIGH tags: layout, cards, swimlanes, safe-zones, overscan, responsive, tv-design

Layout Patterns and Common Components

Quick Reference

  • Use safe zones (5-10% margin) to prevent overscan clipping
  • Leave enough spacing for focus indicators to scale or glow without overlapping adjacent cards
  • Keep row-to-row and card-to-card focus movement visually predictable
  • Test layouts in SDR/HDR and common TV display modes because overscan and color processing vary

Cards and Content Tiles

  • Focus feedback: 3-5% scale increase, glow/drop shadow for depth
  • Leave spacing so focus indicators never overlap adjacent cards
  • Avoid cramming too much info; dense cards are harder to scan from TV distance

Rows / Swimlanes

  • Left/right within a row, up/down between rows
  • Auto-scroll when focus reaches row edge
  • Keep row headers readable and announced as landmarks where appropriate
  • Keep fewer, more distinct categories rather than many nearly identical rows

TV Scroll Alignment

On react-native-tvos, ScrollView has TV-only props for focus-driven snapping:

  • Use snapToAlignment="item" when each child needs its own snap alignment through scrollSnapAlign.
  • Use scrollSnapOffset when different rows/items need different landing offsets.
  • Use scrollAnimationEnabled={false} when animated focus scrolling adds input latency or causes overshoot.

Do not combine TV snapping modes with paging assumptions without testing D-pad focus movement; two scroll-positioning systems can fight each other.

Buttons

  • Focused buttons: contrast, outlines, or subtle scaling
  • Group related actions ("Play" + "More Info") with consistent spacing
  • Short verb labels: "Play", "Retry", "Cancel"

Overlays

Video controls, pause menus:

  • Fade in quickly, fade out after inactivity
  • Predictable focus order (left to right)
  • Dim content beneath but don't hide completely

Safe Zones

Many TVs apply overscan — outer 5-10% may get cropped:

  • Keep all essential elements (text, logos, buttons) inside 5-10% margin
  • Backgrounds and hero images can extend to the edge
  • Use gridlines or bounding boxes during development to visualize safe boundaries

Responsive TV Design

TVs range from 32" to 85" and don't all render pixels identically:

  • Use relative units (viewport height/width, percentages) not fixed pixels
  • Center critical content — peripheral areas less reliable
  • Test multiple display modes: Standard, Cinema, Game, HDR
  • Design around 16:9 base grid, ensure it adapts to 21:9 without breaking

Spacing

  • Consistent vertical rhythm between rows (1.5x card height for padding)
  • Invisible baselines for text/components keep focus transitions smooth
  • TV design prioritizes clarity over space efficiency

Related Skills