tvos

Provides guidance for building focus-driven tvOS apps with SwiftUI and AVPlayerViewController.

4|1|Updated Apr 2, 2026
One-click install
npx skills add https://github.com/AutisticAF/claude-code-apple-dev-plugin --skill tvos-autisticaf
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tvos
Source: https://github.com/AutisticAF/claude-code-apple-dev-plugin/tree/main/skills/tvos
Command: npx skills add https://github.com/AutisticAF/claude-code-apple-dev-plugin --skill tvos-autisticaf

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

tvOS development introduces unique UX and platform constraints—directional focus navigation, Siri Remote input, Top Shelf integration, and media-first interactions—that are easy to get wrong when adapting iOS patterns. This Skill consolidates tvOS patterns and best practices so developers can design predictable focus behavior, use platform button styles, and integrate system media features without losing accessibility or platform polish.

Core Features & Use Cases

  • Guidance on the focus engine, programmatic focus control, and focus grouping for predictable navigation.
  • SwiftUI patterns for tvOS including CardButtonStyle, TabView top-bar navigation, and platform-specific conditional compilation.
  • Media playback recommendations with AVPlayerViewController for Siri integration, transport bars, and metadata.
  • Top Shelf extension approaches for inset and sectioned layouts and TVTopShelfContentProvider examples.
  • Siri Remote handling, onMoveCommand/onPlayPauseCommand/onExitCommand usage, multi-user handling, and migration tips from TVMLKit to SwiftUI.
  • Use Case: Convert an iOS content app to tvOS by replacing touch gestures with focusable Buttons, adopting CardButtonStyle for content cards, and embedding AVPlayerViewController for video playback.

Quick Start

Use the tvos skill to get step-by-step guidance on converting an iOS SwiftUI app to tvOS with focusable card layouts and AVPlayerViewController integration.

Frequently Asked Questions about tvos

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert a SwiftUI iOS app to tvOS with focusable navigation?

tvOS focus navigation replaces touch interaction with directional input. You implement focusable Buttons, apply CardButtonStyle for content cards, and use SwiftUI focus groups to ensure predictable Siri Remote navigation across Apple TV views.

What is the best way to handle Siri Remote input in a tvOS app?

Siri Remote input is handled in SwiftUI using onMoveCommand, onPlayPauseCommand, and onExitCommand modifiers. These map directional selections and button presses to focus engine updates and media transport controls.

How does AVPlayerViewController integration work for tvOS media playback?

AVPlayerViewController integration embeds system-standard transport bars, metadata display, and Siri support into tvOS media playback. It manages video streaming natively, reducing the need for custom UI controls during playback.

Can I use Top Shelf extensions to display content previews on Apple TV?

Top Shelf extensions display content previews on Apple TV using TVTopShelfContentProvider. You implement inset and sectioned layouts to present dynamic media items directly on the tvOS home screen.

Does SwiftUI support multi-user scenarios on tvOS 13 through 16?

SwiftUI supports tvOS multi-user scenarios across versions 13 through 16. Developers manage user profiles and content segregation using platform-specific APIs while maintaining focus engine compatibility.

Why does my tvOS focus engine jump unpredictably between UI elements?

Unpredictable focus jumps occur when focus groups are misconfigured. You resolve this by applying SwiftUI focus grouping modifiers and programmatic focus control to enforce strict directional navigation paths.