Step 1: Dependency Updates

STEP 1:
Dependency Updates

→

STEP 2:
Configuration Files

→

STEP 3:
Vega Configuration

→

STEP 4:
Code Migration

STEP 5:
Carousel Migration

→

STEP 6:
Testing Updates

→

STEP 7:
Build and Verify

Open Beta Documentation Amazon offers this technical documentation as part of a pre-release, open beta. The features described might change as Amazon receives feedback and iterates on the features. For the most current feature information, see the latest Release Notes.

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

Last updated: Jul 09, 2026