Skip to main content

React Native Integration & Best Practices: Multi-Runtime Compatibility

Multi-Runtime Compatibility​

Our architecture supports multiple native runtimes (React Native, Expo, Capacitor). To ensure compatibility:

  • React Native & Expo: Share the same codebase in the app/ directory. Configuration differences are handled via app.json (Expo) or native project files (iOS/Android folders).
  • Capacitor: Utilizes the web build from the shop/ directory.
  • Shared Logic: Business logic in shared/ must remain platform-agnostic or use .native.ts extensions if specific native APIs are required.

Real-World Scenarios:

  • React Native & Expo: Ideal for rich, highly interactive mobile applications requiring native module access or a smooth native user experience. Expo often streamlines development for less complex native features, while pure React Native offers maximum control.
  • Capacitor: Best suited for projects that primarily target a web audience but need to deliver a mobile app experience with access to limited native device features via web technologies. This is perfect for existing web applications wanting a lightweight mobile wrapper.