Vega Multi Tv Migration

Vega Multi-Platform Migration

Overview

Migrate Vega OS (Fire TV) apps to multi-platform React Native monorepo with 70-85% code reuse across Android TV, Apple TV, and Vega OS.

When to Apply

Use this skill when user mentions:

• Migrating Vega/Fire TV app to other platforms
• Building multi-platform TV application
• Converting single-platform TV app to monorepo
• Adding Android TV or Apple TV support
• Sharing code between TV platforms
• Setting up Yarn workspaces for TV apps

Phase Priority Guide

| Priority | Phase | Impact | When to Use | |----------|-------|--------|-------------| | 1 | Analysis | CRITICAL | Starting migration, no existing analysis | | 2 | Implementation | CRITICAL | Have analysis, need monorepo structure | | 3 | Platform Support | HIGH | Have working Vega monorepo, adding platforms | | 4 | Configuration | MEDIUM | Troubleshooting build/resolution issues |

Quick Decision Tree

User has existing Vega app?
├─ YES → Do they have migration analysis?
│  ├─ NO → Start Phase 1 (Analysis)
│  └─ YES → Is monorepo set up?
│     ├─ NO → Start Phase 2 (Implementation)
│     └─ YES → Start Phase 3 (Platform Support)
└─ NO → Starting from scratch?
   └─ YES → Skip Phase 1, start Phase 2 with new project

Quick Reference

Critical: Project Structure

# Verify monorepo structure exists
ls -la packages/shared packages/vega packages/expotv

# Check Yarn workspaces configured
grep -A5 "workspaces:" package.json

Critical: Dependency Classification

Common patterns for analysis:

• Shared: Business logic, UI components, utilities, state management
• Platform-specific: Navigation, video players, DRM, native modules
• VMRP-compatible: Standard RN libraries that map to Vega equivalents

High: VMRP Configuration

Quick check if VMRP is working:

# Should see @vega-tv/react-native-module-resolver-preset
grep "vmrp" packages/vega/babel.config.js

References

Phase 1: Analysis (analysis-*)

| File | Impact | Description | |------|--------|-------------| | [PHASE1ANALYSIS.md](references/PHASE1ANALYSIS.md) | CRITICAL | Codebase analysis, dependency classification, migration planning |

Use when: Starting migration, no existing analysis document

Phase 2: Implementation (impl-*)

| File | Impact | Description | |------|--------|-------------| | [PHASE2IMPLEMENTATION.md](references/PHASE2IMPLEMENTATION.md) | CRITICAL | Monorepo scaffolding, code migration, VMRP setup with template references |

Use when: Have analysis, ready to build monorepo structure

Phase 3: Platform Support (platform-*)

| File | Impact | Description | |------|--------|-------------| | [PHASE3PLATFORMSUPPORT.md](references/PHASE3PLATFORMSUPPORT.md) | HIGH | Android TV and Apple TV implementation |

Use when: Have working Vega monorepo, adding new platforms

Templates

All configuration templates in [assets/templates/](assets/templates/) with companion .md docs:

• root-package.json - Yarn workspaces setup
• root-tsconfig.json - TypeScript project references
• yarnrc.yml - Dependency deduplication (CRITICAL)
• shared-package.json + .md - Shared package config with rules
• vega-metro.config.js - Vega Metro with monorepo resolution
• expotv-package.json + .md - Expo TV package config
• expotv-app.json + .md - Expo TV configuration with plugins
• expotv-metro.config.js - Expo Metro with TV extensions

Problem → Skill Mapping

| Problem | Start With | |---------|------------| | Need to analyze existing Vega app | PHASE1ANALYSIS.md | | Have analysis, need monorepo setup | PHASE2IMPLEMENTATION.md → templates | | Monorepo exists, adding Android TV | PHASE3PLATFORMSUPPORT.md | | Metro resolution errors | PHASE2IMPLEMENTATION.md → Metro config | | Duplicate React versions | PHASE2IMPLEMENTATION.md → .yarnrc.yml | | VMRP not mapping imports | PHASE2IMPLEMENTATION.md → VMRP section | | TypeScript path errors | PHASE2IMPLEMENTATION.md → TypeScript config | | Native module integration | PHASE3PLATFORMSUPPORT.md → Native Modules | | Build configuration issues | PHASE2IMPLEMENTATION.md → Configuration Files | | Starting from scratch | PHASE2IMPLEMENTATION.md (skip Phase 1) |

Workflow

1. Use the decision tree above to determine the starting phase
2. Load the appropriate reference file for that phase
3. Follow Quick Start → Deep Dive pattern in each reference
4. Verify at each phase's checkpoint before moving to the next phase
5. Use [VALIDATIONCHECKLIST.md](assets/templates/VALIDATIONCHECKLIST.md) for comprehensive verification

Attribution

Based on Vega OS multi-platform migration patterns and React Native monorepo best practices.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: AmazonAppDev
• Source: AmazonAppDev/devices-agent-skills
• License: MIT

Install and usage instructions live in the source repository linked above.