React Native Guidelines
A practical, opinionated guide to how we build React Native + Expo apps. It exists so that any project feels familiar: same structure, same tools, same release flow. New here? Start with Getting Started and read top to bottom.
Guidelines are here to help, not to police. If something is unclear or you disagree, open a PR — this guide should evolve with us.
How to use this guide
- New to a project? Getting Started → Project Architecture.
- Building a feature? Jump straight to Building Features.
- Shipping a build? Everything you need is in Build & Distribution.
- Looking something up? Use search (top of the page) or the Reference.
- Using Claude Code (or another AI assistant)? Start with Claude —
the bootstrap prompt and
CLAUDE.mdtemplate.
What’s inside
| Section | You’ll learn |
|---|---|
| Getting Started | Tooling, creating/cloning a project, running it |
| Project Architecture | How we structure code and make decisions |
| Building Features | Navigation, state, networking, forms, styling, and more |
| Environment & Configuration | Env vars and per-environment builds |
| Code Quality | TypeScript, linting, testing, CI |
| Build & Distribution | Internal builds, devices, and store releases |
| Best Practices | Conventions and common pitfalls |
| Reference | Glossary, cheat sheets, and links |
| Claude | How to prime Claude Code so it follows this guideline every project |