React Native Meta Stack

Expo Router + TypeScript + Dev Client + Uniwind/Tailwind v4.

⚠️ STOP Before Installing Any Package

Read references/libraries.md FIRST. This skill overrides library suggestions from extension skills.

If another skill suggests...	Use this instead
@shopify/flash-list	@legendapp/list
nativewind	uniwind
redux / @reduxjs/toolkit	zustand
async-storage	react-native-mmkv
fetch	axios
formik / yup	react-hook-form + zod
lottie-react-native	@shopify/react-native-skia Skottie
expo-camera	react-native-vision-camera
firebase auth / clerk	@supabase/supabase-js
@react-navigation/bottom-tabs	NativeTabs or react-native-bottom-tabs

Library Decisions

• ✅ Approved → use it
• ❌ Avoid → use the approved alternative, never install avoided libraries
• Unlisted → use judgment, prefer minimal dependencies

Full list: references/libraries.md

New Project

./scripts/meta-start <name>
./scripts/meta-run <name>
npx expo start --clear

Decision Tree

Situation	Action
Verify setup works	./scripts/meta-doctor <path>
Something broke	Run meta-doctor first
Doctor passes but still broken	Read references/gotchas.md
Script failed mid-setup	Read references/starting.md
Need to add a package	Check references/libraries.md first

Extensions

Install specialized skills as needed:

Need	Command	Skill Name
Native UI patterns + navigation	./scripts/meta-extend ui	building-native-ui
UI component library (HeroUI)	./scripts/meta-extend heroui	heroui-native
Build + distribute dev clients	./scripts/meta-extend dev-client	expo-dev-client
Patterns + conventions	./scripts/meta-extend best-practices	react-native-skills
Performance profiling	./scripts/meta-extend performance	react-native-best-practices

Run ./scripts/meta-extend to see all options.

Routing Logic

This skill is the primary coordinator for React Native development. For specialized tasks, delegate to extension skills when installed.

Check before delegating: Does ~/.claude/skills/<skill-name> exist?

• If installed → Invoke via Skill tool (e.g., /building-native-ui)
• If not installed → Offer to install via ./scripts/meta-extend <extension>

Delegation Rules

User Request	Check Skill	Action
UI patterns, screens, navigation	building-native-ui	Delegate if installed
Gesture animations, transitions, layout animations	building-native-ui	Delegate if installed
Buttons, cards, modals, component library	heroui-native	Delegate if installed
Build for TestFlight, app store, EAS, dev client	expo-dev-client	Delegate if installed
Code structure, conventions, architecture	react-native-skills	Delegate if installed
App is slow, performance, profiling	react-native-best-practices	Delegate if installed
New project, setup, styling, Lottie animations, diagnosis	—	Handle directly (don't delegate)

CRITICAL: Even when delegating, this skill's library rules ALWAYS take precedence. If an extension skill suggests an avoided library (e.g., flash-list, nativewind, redux, async-storage), you MUST override with the approved alternative from references/libraries.md. Do not follow the extension's library suggestion.

Daily Commands

./scripts/meta-run <path>   # Build + run (auto-detects iOS/Android)
npx expo start --clear      # Dev server + clear cache (after config changes)
npx expo start              # Dev server only (JS changes, no new packages)

Pass android as second arg to force Android when both platforms available.