react-native

Layer 2 — Framework Pack

React Native patterns for the New Architecture era (0.76+). Fabric, TurboModules, Expo, navigation, and the mistakes agents make from old Bridge-era training data.

Philosophy

React Native underwent a fundamental architectural shift. The old Bridge (async JSON serialization between JS and native) is replaced by JSI (direct synchronous C++ references). Fabric replaces the old UI Manager. TurboModules replace legacy Native Modules. Starting from RN 0.82, the New Architecture is always-on and can't be disabled.

LLMs trained on 2018-2023 content produce Bridge-era patterns: old lifecycle methods, legacy navigation libraries, manual native module boilerplate. This pack establishes New Architecture as the baseline and corrects stale patterns.

What's Included

Type	Files	Coverage
Patterns	7	New Architecture, Expo workflow, navigation, state management, native modules, lists, styling
Anti-patterns	5	Bridge-era patterns, wrong navigation library, blocking JS thread, inline styles everywhere, unnecessary native modules
Constitution	1	5 React Native-specific principles
Gate	1	RN pattern compliance check

Stack Integrations (detection-gated)

When expo is detected, read integration/expo-integration.md for the Expo + React Navigation + Zustand + MMKV + TanStack Query seams — navigation guards, store hydration, offline cache, and Expo Router auth flows — that the individual docs don't cover together. This folds in the former stack-react-native-expo skill; the content is unchanged. Constitution: constitution/expo.constitution-additions.md · anti-patterns: anti-patterns/expo-anti-patterns.md.