Apple TV

Hosanna supports Apple TV as a native TV target. Shared application code stays in TypeScript while the Apple TV target owns native packaging, platform services, media integration, and App Store delivery.

Development Flow

1. Build screens, state, styles, fragments, and input behavior in shared Hosanna code.
2. Run Apple TV with npx hst run apple-tv dev sim --device "<simulator name>". Add --hot-reload for the opt-in JavaScript dev-server loop.
3. Validate focus movement using the Siri Remote and keyboard input where supported.
4. Test media playback, app lifecycle, safe areas, remote gestures, and networking on a physical Apple TV.
5. Package through the native Apple release workflow.

Runtime Notes

• Directional input should use the shared HsInputEvent model and focused view onInputEvent(event) handlers.
• Platform services should be wrapped behind adapters so shared screens do not import Apple-only APIs directly.
• AppConfig fragments, styles, callbacks, and data maps should remain shared unless the platform needs a targeted override.

Release Checklist

• Confirm bundle identifiers, signing, provisioning, and entitlements.
• Validate app startup, focus, video, network retries, and lifecycle resume.
• Check typography, image assets, overscan-safe layout, and remote-control behavior.
• Run the shared Web validation path before final Apple TV device testing.