All skills
callstackincubator avatar

/react-native-tv-best-practices

@fa0bad0 official

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.

Use this Skill: https://skilld.dev/gh/callstackincubator/agent-skills/react-native-tv-best-practices

This session only. Nothing lands on disk.

referencesdesign-10foot.md

≈756 tokens on demand. Your agent reads this file only when SKILL.md points to it.

The 10-Foot Experience

TV UIs are viewed from ~3 m (10 ft) with a D-pad remote, not 30 cm with a touchscreen. This file covers the TV-specific design concerns that follow from that distance and input model. For the concrete numbers, defer to the focused references:

Quick Reference

  • Design for legibility at 3 m; verify by testing from a couch with a remote, not at a desk with a keyboard.
  • Acknowledge every remote press with a visual cue within ~100 ms.
  • Keep focus/transition animations under 200 ms so they never delay the next input.
  • Treat the TV as a shared device — don't expose personal data by default.

Input Latency and Feedback

TV hardware and remotes add ~100–200 ms between a button press and the on-screen response. Mask that latency, don't add to it:

  • Show a focus cue (highlight, ~3–5% scale, or border) within ~100 ms of every press.
  • Keep focus and transition animations under 200 ms; an animation that outlasts the next press is too long.
  • Use motion only to reinforce direction or highlight focus changes — never decorative sequences that block input.

Shared Screen Considerations

TVs are shared among family, roommates, and guests — design for that:

  • Don't display account email, payment details, or other personal data unless the action requires it.
  • Make profile switching reachable within 2 D-pad presses from the home screen.
  • Show a confirmation step for voice-entered text before submitting it.
  • Auto-dismiss subtitles, overlays, and menus on a timer once they've served their purpose.

Couch Test Checklist

Test each completed screen from the intended viewing position (couch, remote, ~3 m). Each step is pass/fail:

  1. Reach the first Play action from the home screen in ≤3 D-pad presses.
  2. Return to the starting screen using only the Back button.
  3. After every directional press, focus lands on a visible element (no off-screen or lost focus).
  4. Every press produces a visible cue within ~100 ms.
  5. Screen remains legible with room lights both on and off.

If a step fails, reduce the number of focusable elements or realign the layout before adding manual nextFocus* overrides.

Related Skills

Source: SKILL.md on GitHub

No alerts1mo3 checks · Risk SAFE
  • Gen Agent Trust Hub1mo

    This skill provides comprehensive documentation and best practices for developing React Native applications for TV platforms. It contains technical guidelines for focus management, performance, and video playback without any malicious patterns, obfuscation, or unsafe code execution.

  • Socket1mo

    No alerts

  • Snyk1mo

    Risk: LOW · No issues

Signed by skilld at fa0bad0. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 2 weeks ago.

Activeupdated 2 months ago

README badge

README badge for callstackincubator/agent-skills/react-native-tv-best-practices