TV Example

Creates a project that can build for Apple TV and Android TV targets.

This project uses

• the React Native TV fork, which supports both phone (Android and iOS) and TV (Android TV and Apple TV) targets
• the React Native TV config plugin to allow Expo prebuild to modify the project's native files for TV builds

🚀 How to use

Creating a new project

• Create a project: npx create-expo-app -e with-tv
• cd into the project

export EXPO_TV=1
npx expo prebuild
yarn ios # Build for Apple TV
yarn android # Build for Android TV

NOTE: Setting the environment variable EXPO_TV=1 enables the @react-native-tvos/config-tv plugin to modify the project for TV. This can also be done by setting the parameter isTV to true in the app.json.

TV specific file extensions

This project contains an example Metro configuration that allows Metro to resolve application source files with TV-specific code, indicated by specific file extensions (*.ios.tv.tsx, *.android.tv.tsx, *.tv.tsx). This config is not enabled by default, since it will impact bundling performance, but is available for developers who need this capability.

TV specific app icons and banners

This project contains placeholder images for the Android TV banner and for Apple TV brand assets (app icon and top shelf images). The config-tv plugin will use these images to construct the required native image files and make the right modifications in project files. You can simply replace these images with your own app images. Note that for Apple TV, the images must be the exact sizes indicated.