Expo Router TV demo 👋

This is an Expo project created with create-expo-app.

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

• cd into the project

• For TV development:

yarn
yarn prebuild:tv # Executes clean Expo prebuild with TV modifications
yarn ios # Build and run for Apple TV
yarn android # Build for Android TV
yarn web # Run the project on web from localhost

• For mobile development:

yarn
yarn prebuild # Executes Expo prebuild with no TV modifications
yarn ios # Build and run for iOS
yarn android # Build for Android mobile
yarn web # Run the project on web from localhost

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.

Development

You can start developing by editing the files inside the app directory. This project uses file-based routing.

This project includes a demo showing how to use React Native TV APIs to highlight controls as the user navigates the screen with the remote control.

Deploy

Deploy on all platforms with Expo Application Services (EAS).

• Deploy the website: npx eas-cli deploy — Learn more
• Deploy on iOS and Android using: npx eas-cli build — Learn more

TV specific file extensions

This project includes 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).

Get a fresh project

When you're ready, run:

npm run reset-project

This command will move the starter code to the app-example directory and create a blank app directory where you can start developing.

Learn more

To learn more about developing your project with Expo, look at the following resources:

• Expo documentation: Learn fundamentals, or go into advanced topics with our guides.
• Learn Expo tutorial: Follow a step-by-step tutorial where you'll create a project that runs on Android, iOS, and the web.

Join the community

Join our community of developers creating universal apps.

• Expo on GitHub: View our open source platform and contribute.
• Discord community: Chat with Expo users and ask questions.