Step 1: Dependency Updates - Amazon Vega Docs

1.1 Update core dependencies

Replace the relevant sections of your package.json dependencies with the new versions for RN 0.83.

{
  "dependencies": {
    "react": "19.2.0",
    "react-native": "0.83.0",
    "@amazon-devices/react-native-kepler": "4.0.0",
    "@react-native/new-app-screen": "0.83.0",
    "react-native-safe-area-context": "^5.5.2"
  },
  "devDependencies": {
    "@babel/core": "^7.25.2",
    "@babel/preset-env": "^7.25.3",
    "@babel/runtime": "^7.25.0",
    "@react-native/babel-preset": "0.83.0",
    "@react-native/eslint-config": "0.83.0",
    "@react-native/metro-config": "0.83.0",
    "@react-native/typescript-config": "0.83.0",
    "@react-native-community/cli": "11.3.2",
    "@types/react": "^19.2.0",
    "@types/react-test-renderer": "^19.1.0",
    "@types/jest": "^29.5.0",
    "babel-jest": "^29.6.3",
    "eslint": "^8.57.0",
    "jest": "^29.6.3",
    "prettier": "2.8.8",
    "react-test-renderer": "19.2.0",
    "ts-jest": "^29.1.0",
    "typescript": "5.8.3",
    "@amazon-devices/keplerscript-commonmodules": "^1.0.0"
  },
  "engines": {
    "node": ">=22.14.0"
  }
}

Required dependencies for RN83 The following dependencies are required for RN83:

@react-native-community/cli: @amazon-devices/kepler-cli-platform requires version 11.3.2 to register the vega build command. Removing it causes npm run build:release to fail with “Unrecognized command vega build”.
jest dependencies:jest, babel-jest, ts-jest, and @types/jest must ALL be v29. Mixing v28 and v29 causes ERESOLVE unable to resolve dependency tree.
react overrides: If you have an overrides section with "react", update it to "19.2.0":
"overrides": { "react": "19.2.0" }

1.2 Update third-party packages

Update all third-party packages to their RN 0.83 compatible versions. See Supported Libraries and Services for the complete version table. Example of common packages

{
  "@amazon-devices/react-native-reanimated": "~4.0.0",
  "@amazon-devices/react-native-worklets": "~1.0.0",
  "@amazon-devices/react-native-gesture-handler": "~4.0.0",
  "@amazon-devices/react-native-screens": "~3.0.0",
  "@amazon-devices/react-native-svg": "~3.0.0",
  "@amazon-devices/react-native-fast-image": "~3.0.0",
  "@amazon-devices/kepler-ui-components": "^3.0.0",
  "@amazon-devices/react-native-localize": "~2.1.0",
  "@amazon-devices/react-native-async-storage__async-storage": "~2.1.0"
}

1.3 Additional library updates

Some libraries have new requirements for React Native 0.83:

react-native-reanimated requires react-native-worklets. If your app uses @amazon-devices/react-native-reanimated, you must also add @amazon-devices/react-native-worklets as a dependency. This is a new required runtime dependency in reanimated 4.0.0. Without it, the app crashes on launch with no clear error message.
@amazon-devices/shopify__flash-list is not compatible with RN 0.83. Use the upstream @shopify/flash-list@2.1.0 package directly instead. The wrapped version has a module resolution error in RN 0.83’s split-bundle system.
kepler-ui-components must be 3.0.0+. Version 2.x bundles its own copy of react-native with a transitive dependency, causing Jest test failures with Flow/ESM parse errors. This applies to all apps using kepler-ui-components, not just carousel users.

1.4 Install dependencies

Run npm install to receive all other dependencies.

# Clean install to avoid stale cache conflicts
rm -rf node_modules package-lock.json
npm install

​1.1 Update core dependencies

​1.2 Update third-party packages

​1.3 Additional library updates

​1.4 Install dependencies

1.1 Update core dependencies

1.2 Update third-party packages

1.3 Additional library updates

1.4 Install dependencies