Skip to content
Agent Friendly Code

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:8081
  • npx expo run:iosbuild and run the native app; or run:android
  • npx expo install <pkg>a version compatible with your SDK
  • npx expo prebuildregenerate ios/ and android/ from app config
  • npx 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/ and android/ 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=false and RCT_NEW_ARCH_ENABLED=0 are ignored.
  • With generated native folders, don't edit ios/ or android/: prebuild overwrites them. Use a config plugin.
  • Add libraries with npx expo install, not a bare npm 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.

React Native repos with an AGENTS.md or CLAUDE.md
RepoFileLengthStarsLanguageScore
expo/expoAGENTS.md 9,935 chars53.7k ★TypeScript78.2
bluesky-social/social-appAGENTS.md 23,204 chars18.4k ★TypeScript78.2
Uniswap/interfaceAGENTS.md 11,442 chars5.5k ★TypeScript82.5
Expensify/AppAGENTS.md 9,439 chars5.1k ★TypeScript77.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