What to put in an AGENTS.md for React Native
Agents learned React Native while the Legacy Architecture still existed; since 0.82 the New Architecture is the only one. State the Expo SDK and whether ios/ and android/ are generated. create-expo-app now adds an AGENTS.md that points at docs for your SDK.
By Himanshu Singh · Updated · How we score →
Which commands should it list?
npx expo startdev server (Metro) on localhost:8081npx expo run:iosbuild and run the native app; orrun:androidnpx expo install <pkg>a version compatible with your SDKnpx expo prebuildregenerateios/andandroid/from app confignpx expo-doctordiagnose project and dependency problems
Write them as your repo runs them, with its package manager and flags, plus how to run one test.
What layout should it explain?
- Whether
ios/andandroid/are gitignored and generated, or committed and maintained by hand. - Where native changes live: config plugins and
app.json/app.config, not the generated folders. - The Expo SDK, and whether Expo Router is used and where its
app/directory is.
What do agents get wrong?
- New Architecture only since 0.82:
newArchEnabled=falseandRCT_NEW_ARCH_ENABLED=0are ignored. - With generated native folders, don't edit
ios/orandroid/: prebuild overwrites them. Use a config plugin. - Add libraries with
npx expo install, not a barenpm install, so versions match the SDK.
From the official docs: docs.expo.dev/agents (new tab) · docs.expo.dev/continuous-native-generation (new tab) · docs.expo.dev/expo-cli (new tab) · reactnative.dev/react-native-0.82 (new tab). The rest of the file is the same for any project: what goes in an AGENTS.md.
React Native repos with an AGENTS.md or CLAUDE.md (4)
Built on React Native; 4 pass the AGENTS.md check in full.
| Repo | File | Length | Stars | Language | Score |
|---|---|---|---|---|---|
| expo/ | AGENTS.md | 9,935 chars | 53.7k ★ | TypeScript | 78.2 |
| bluesky-social/ | AGENTS.md | 23,204 chars | 18.4k ★ | TypeScript | 78.2 |
| Uniswap/ | AGENTS.md | 11,442 chars | 5.5k ★ | TypeScript | 82.5 |
| Expensify/ | AGENTS.md | 9,439 chars | 5.1k ★ | TypeScript | 77.3 |
By language: TypeScript AGENTS.md examples · JavaScript AGENTS.md examples
More examples: Next.js · React · FastAPI · Flutter · Android · .NET · Rails · Vue · Laravel · Django · Angular · Spring Boot · iOS · all examples