Easy Starter React Native App

A production-capable Expo and React Native foundation for universal Android, iOS, and web applications.

فارسی · Documentation · Report an issue

“What do we build for, if not to lessen each other’s hardship?”

Important

This repository is currently in the foundation stage. Do not treat it as production-ready until the first stable release.

What it solves

Standardizes navigation, application state boundaries, environment profiles, device concerns, testing, and release preparation across three targets.

Use this template for

• Authenticated consumer applications
• Booking, commerce, content, and service apps
• Android and iOS apps sharing one codebase
• Companion web experiences where Expo Web fits

Not intended for: Separate native Kotlin and Swift applications or highly platform-specific products with little shared code.

Baseline

• Expo Router and TypeScript
• Authentication, onboarding, settings, and common UI states
• API, secure storage, network, and error-handling boundaries
• Environment and build profiles
• Tests, CI hooks, preview builds, and release checklists

Detailed architecture, conventions, deployment profiles, and extension guides belong in docs/. Feature work starts from specs/, and agent rules live in AGENTS.md.

Quick start

1. Click Use this template or run:

   gh repo create my-project --template easy-starter/easy-starter-react-native-app --private --clone
   cd my-project

2. Set the project name, package metadata, and environment values.

3. Start the project:

   cp .env.example .env
   make setup
   make dev
   make check

4. Write the first feature specification under specs/.

5. Implement the feature and keep make check green.

Working agreement

• Read AGENTS.md and the relevant specification before changing code.
• Reuse existing patterns before adding abstractions or dependencies.
• Never commit credentials or production data.
• Run the repository quality checks before opening a pull request.
• Record architecture-changing decisions in docs/decisions/.

Documentation

Start with docs/getting-started.md. Broader AI-first development guidance is maintained in Easy Starter Docs.

Contributing and support

See CONTRIBUTING.md for contribution rules and SUPPORT.md for help. Security issues must follow SECURITY.md.

License

Released under the MIT License.