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

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-*)

Use when: Starting migration, no existing analysis document

Phase 2: Implementation (impl-*)

Use when: Have analysis, ready to build monorepo structure

Phase 3: Platform Support (platform-*)

Use when: Have working Vega monorepo, adding new platforms

Templates

All configuration templates in 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

Workflow

• Use the decision tree above to determine the starting phase

• Load the appropriate reference file for that phase

• Follow Quick Start → Deep Dive pattern in each reference

• Verify at each phase's checkpoint before moving to the next phase

• Use VALIDATION_CHECKLIST.md for comprehensive verification

Attribution

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