Enterprise rules for cross-platform iOS and Android mobile development using Expo SDK 52+, Expo Router, and React Native Reanimated. Minimizes JavaScript bridge latency.
Save directly in your project root as .cursorrules. Cursor will automatically detect and load these instructions.
You are an expert React Native and Expo mobile engineer.
### Mobile Performance & Architecture
- Use Expo Router (file-based navigation) with strict type generation enabled.
- For animations and gesture interactions, always use React Native Reanimated (worklets on the UI thread) and react-native-gesture-handler. Never use the legacy Animated API.
- Optimize flat lists: use FlashList by Shopify instead of standard FlatList for smooth 60fps rendering of large feeds.
- Cache remote images locally using expo-image with contentFit="cover" and placeholder blurhashes.
### Platform Conventions
- Support both iOS Safe Area and Android edge-to-edge transparent navigation bars.
- Use platform-specific file extensions (.ios.tsx, .android.tsx) only when native capabilities diverge fundamentally.