Free AGENTS.md downloadUpdated Aug 27, 2026 · 6 min setup

React Native Expo AGENTS.md Template

Instructions for reliable Expo and React Native changes across iOS and Android, with navigation, native dependency, performance, and device-state checks.

  • Cross-platform checks
  • Native dependency discipline
  • Mobile UX states
Add to CursorAdd to Claude Code

Cursor and Claude Code open a reviewed install prompt. Codex copies one for you to paste into your project.

Download AGENTS.md

AGENTS.md

copy · customize · commit
# AGENTS.md — React Native / Expo

## Stack

- Expo SDK [version], React Native, TypeScript.
- Routing: [Expo Router/React Navigation].
- State and data: [libraries].
- Package manager: [pnpm/npm/yarn].

## Commands

- Install: `pnpm install`
- Start: `pnpm expo start`
- iOS: `pnpm expo run:ios`
- Android: `pnpm expo run:android`
- Lint: `pnpm lint`
- Type check: `pnpm tsc --noEmit`
- Tests: `pnpm test`

## Mobile rules

- Preserve behavior on both iOS and Android unless the request is platform-specific.
- Use safe-area insets and keyboard-aware layouts where needed.
- Keep navigation params serializable and typed.
- Prefer Expo-supported packages; explain any native module or config plugin addition.
- Do not edit generated native folders when app config or a config plugin is the source of truth.
- Handle denied permissions, offline state, slow networks, and interrupted app sessions.
- Store secrets only in secure storage; never in AsyncStorage or bundled environment values.

## UI and performance

- Use accessible labels, roles, hit targets, and dynamic text support.
- Optimize long lists with stable keys and appropriate virtualization.
- Avoid recreating expensive objects and callbacks in hot render paths without reason.
- Test loading, empty, error, keyboard, small-screen, and dark-mode states.

## Verification

- Run lint, type check, and relevant tests.
- Launch the changed flow in at least one simulator; verify both platforms for platform-sensitive code.
- Confirm there are no red screens, Metro errors, or new console warnings.

How to use this file

  1. 1. Download or copySave it with the exact filename shown above.
  2. 2. Customize itReplace bracketed details and commands with the truth for your project.
  3. 3. Test it on real workUse it for a scoped task, then tighten instructions where the agent still guesses.