react-native-expo-architect

Designs and audits Expo SDK 54+ React Native apps using the New Architecture and EAS Build.

1|Updated May 4, 2026
One-click install
npx skills add https://github.com/Scardubu/SwarmXQ --skill react-native-expo-architect-scardubu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: react-native-expo-architect
Source: https://github.com/Scardubu/SwarmXQ/tree/main/.ai/skills/react-native-expo-architect
Command: npx skills add https://github.com/Scardubu/SwarmXQ --skill react-native-expo-architect-scardubu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Expo SDK 54 introduced breaking changes with the New Architecture, Reanimated v4, and deprecated APIs like expo-av, and missing any of them causes build failures or runtime errors that are hard to diagnose. ## Core Features & Use Cases - Project Setup & Migration: Scaffolds new Expo SDK 54 projects with TypeScript and upgrades existing apps with newArchEnabled, edge-to-edge Android, and typed routes configured correctly. - Reanimated v4 Animations: Implements worklet-based animations, enter/exit transitions, layout animations, and scroll-driven effects compatible with the New Architecture. - EAS Build & OTA Deployment: Configures eas.json profiles for development, preview, and production builds, store submission, and expo-updates OTA delivery. - Use Case: You are migrating an Expo SDK 53 app and your animations break after upgrading Reanimated. This Skill identifies the stale babel plugin, adds the react-native-worklets peer dependency, and rewrites the animation code for v4. ## Quick Start Ask the assistant to set up a new Expo SDK 54 project with Expo Router, Reanimated v4 animations, and an EAS production build profile.

Frequently Asked Questions about react-native-expo-architect

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I migrate an Expo app to the New Architecture?

Set newArchEnabled to true in app.json and upgrade with npx expo install expo@54. The New Architecture is default in SDK 54 and becomes mandatory in SDK 55, so also verify all dependencies support TurboModules and the Fabric renderer.

How do I set up Reanimated v4 in Expo SDK 54?

Install react-native-reanimated and react-native-worklets with npx expo install, then remove react-native-reanimated/plugin from babel.config.js since babel-preset-expo handles it. Reanimated v4 only supports the New Architecture.

Does Reanimated v4 work with the old React Native architecture?

No, Reanimated v4 only supports the New Architecture and requires react-native-worklets as a peer dependency. Apps still on the old architecture must stay on Reanimated v3 or migrate first.

Why does my Expo build fail after upgrading to SDK 54?

Common causes are the leftover react-native-reanimated/plugin in babel.config.js, missing react-native-worklets, or using deprecated expo-av instead of expo-audio and expo-video. Check the quality gates checklist for each breaking change.

How do I configure EAS Build for production app store submission?

Define a production profile in eas.json with distribution set to store, app-bundle build type for Android, and a production channel. Run eas build --profile production --platform all, then eas submit with your store credentials configured.

Can I share code between a Next.js web app and an Expo mobile app?

Yes, use a Turborepo with shared packages for UI components, hooks, and API clients. Metro automatically picks .native.tsx file variants on mobile, so Button.tsx serves web while Button.native.tsx serves Expo.