VegaOS App

A React Native application for Amazon Fire TV, built on the Vega OS platform. It demonstrates TV-optimized UI patterns including D-pad navigation, focus management, and 10-foot UI design.

Prerequisites

• Node.js (or Bun)
• Vega SDK toolchain
• Amazon Fire TV device or emulator (aarch64)

Getting Started

# Install dependencies
npm install

# Start the React Native dev server
npm start

Scripts

Command	Description
npm start	Start the React Native dev server
npm run build	Build the release variant for Vega OS
npm run build:debug	Build the debug variant
npm run build:app	Build the release app package
npm test	Run Jest tests
npm run lint	Lint the codebase with ESLint
npm run lint:fix	Auto-fix linting issues
npm run clean	Remove all build artifacts
npm run release	Full pipeline: lint, test, and build

Project Structure

src/
  App.tsx               # Root component and navigation setup
  navigation/
    types.ts            # Navigation type definitions
  screens/
    HomeScreen.tsx      # Feed grid with focusable cards
    DetailScreen.tsx    # Item detail and QR code pairing
    AboutScreen.tsx     # About page with TV event handling
  components/
    Link.tsx            # Reusable link with focus states
  data/
    feed.ts             # Sample feed data
  assets/               # Images and icons
test/                   # Jest test files

Tech Stack

• React Native 0.72 with React 18
• TypeScript 4.8
• @amazon-devices/react-navigation (stack navigation for TV)
• @amazon-devices/react-native-kepler (Kepler runtime, TV events)
• @amazon-devices/react-native-screens (screen optimization)
• Jest + React Testing Library for testing

Building for Fire TV

Debug and release builds produce .vpkg packages targeting aarch64:

# Debug build
npm run build:debug

# Release build
npm run build

Build output lands in build/.

App Manifest

The app is configured in manifest.toml as a singleton interactive component running on the KeplerScript runtime. The package ID is com.galaxies.simonsapp.