react-native-app-starter

This project is a React Native boilerplate that can be used to kickstart a mobile application.

The boilerplate provides an optimized architecture for building solid cross-platform mobile applications through separation of concerns between the UI and business logic. It contains redux, saga, context, theme, localization, tabs and stack navigation.


Getting Started

Creates a new React Native project with TypeScript template:

``bash


Using npx with default package manager (bun)

$ npx react-native-app-starter

Using bunx with default package manager (bun)

$ bunx react-native-app-starter

Specifying a different package manager

$ npx react-native-app-starter --pm yarn
$ npx react-native-app-starter --pm npm

$ cd

$ npx react-native run-ios

$ npx react-native run-android
`

$3

The CLI supports three package managers:

- bun (default) - Automatically installed if not present
- yarn - Prompts for installation if not present
- npm - Should be available with Node.js installation




Directory Structure

`
root
├── __tests__
├── android
├── ios
└── App
└── ApiConfig
└── AppContext
└── Routes
└── Screens
| CommonComponent
| Components
| SubComponents
└── Services
└── Slices
| ├──Default
└── Stores
└── Thunks
└── Theme
| Images
| Colors
└── Utils
├── fastlane
├── .env
...
`




Preconfigured with

- Latest react native version

- Redux Toolkit

- Theme support (Dark / Light)

- Utility for validations and error messages

- Custom font and font size for maintain typography

- .env and fastlane setup

- Support different env for PRODUCTION and DEVELOPMENT

- User Authentication flow

- UI for Login, Tabs and Settings




Predefined UI

Expand for screenshots

iOS
Android

Development

This CLI tool is built with TypeScript and provides a modular architecture for easy maintenance and testing.

$3

`
├── src/
│ ├── config/ # Configuration constants
│ ├── services/ # Business logic services
│ ├── utils/ # Utility functions
│ ├── types/ # TypeScript type definitions
│ └── index.ts # Main exports
├── dist/ # Compiled JavaScript output
├── index.ts # CLI entry point
└── tsconfig.json # TypeScript configuration
`

$3

- npm run build - Compile TypeScript to JavaScript
- npm run dev - Build and run the CLI tool
- npm run test:modules - Run example tests
- npm run clean - Remove compiled output

$3

`bash


Clone the repository

git clone
cd react-native-app-starter

Install dependencies

npm install

Build the project

npm run build

Test the CLI

node dist/index.js --help
`

$3

After publishing, the package can be used with:

`bash


Using npx

npx react-native-app-starter my-app

Using bunx

bunx react-native-app-starter my-app
``