Getting Started
RNCopilot is a production-grade React Native Expo template designed as a reusable foundation for mobile applications. It ships with 33 themed UI components, authentication, internationalization, state management, API integration, and comprehensive AI agent instructions — everything you need to go from idea to production without reinventing the wheel.
Who Is This For?
RNCopilot is built for developers and teams who want to:
- Ship faster — Skip weeks of boilerplate setup and start building features on day one.
- Maintain quality — TypeScript strict mode, ESLint 9, Prettier, and pre-commit hooks enforce code quality from the start.
- Work with AI — Instruction files for Claude Code, Cursor, Windsurf, Cline, Copilot, and Codex mean your AI assistant understands the codebase immediately.
- Scale confidently — The architecture supports everything from simple utility apps to complex multi-feature products.
What’s Included
Core Infrastructure
| Feature | Details |
|---|---|
| Framework | React Native 0.83.2 + Expo SDK 55 |
| Routing | expo-router with file-based, typed routes |
| TypeScript | v5.9 in strict mode with path aliases (@/*, ~/*) |
| Styling | react-native-unistyles 3.x with semantic theme tokens |
UI Components (33)
A complete component library organized by category:
- Action — Button, IconButton
- Data Display — Text, Avatar, Badge, Card, Chip, ListItem
- Disclosure — Accordion
- Feedback — EmptyState, ErrorBoundary, Loading, ProgressBar, Skeleton, Snackbar
- Form — Checkbox, FormField, Input, RadioGroup, SearchBar, SegmentedControl, Select, Switch, TextArea
- Layout — Divider, ScreenContainer
- Overlay — Dialog, Menu
- Typography — Icon, Text
State & Data
| Layer | Technology |
|---|---|
| Server State | @tanstack/react-query with MMKV persistence |
| Client State | Zustand stores with selectors |
| Persistent Storage | react-native-mmkv with typed keys |
| API Client | Axios with auth and error interceptors |
| Backend | Supabase (graceful degradation if unconfigured) |
Developer Experience
- Forms — react-hook-form + Zod with i18n error messages
- i18n — English and Arabic with full RTL support
- Auth — Zustand-based auth store, Supabase integration, route protection
- Migration — Interactive CLI wizard to customize the template for your app
- Testing — Jest 30 + jest-expo infrastructure
- Code Quality — ESLint 9, Prettier, Husky, Commitlint
How to Navigate These Docs
New to RNCopilot? Follow the pages in this section in order for the smoothest onboarding experience.
| Page | What You’ll Learn |
|---|---|
| Quick Start | Clone, install, and run the app in under 5 minutes |
| Project Structure | Understand the directory layout, component patterns, and feature modules |
| Environment Setup | Configure environment variables, tooling, and build scripts |
Once you are comfortable with the basics, explore the rest of the documentation to dive into the theme system, component APIs, authentication, internationalization, and migration guides.
Last updated on