11# React Native Clean Architecture Starter 🚀
22
3- ![ React Native] ( https://img.shields.io/badge/react--native-0.83.4-blue )
4- ![ TypeScript] ( https://img.shields.io/badge/typescript-5.8.3-blue )
5- ![ License] ( https://img.shields.io/badge/license-MIT-green )
6-
7- [ ![ Unit Tests] ( https://github.com/alejandro-technology/react-native-template/actions/workflows/unit-test.yml/badge.svg?branch=main )] ( https://github.com/alejandro-technology/react-native-template/actions/workflows/unit-test.yml )
8- [ ![ APK Build] ( https://github.com/alejandro-technology/react-native-template/actions/workflows/android-apk.yml/badge.svg?branch=main )] ( https://github.com/alejandro-technology/react-native-template/actions/workflows/android-apk.yml )
9- [ ![ iOS Build] ( https://github.com/alejandro-technology/react-native-template/actions/workflows/ios-build.yml/badge.svg?branch=main )] ( https://github.com/alejandro-technology/react-native-template/actions/workflows/ios-build.yml )
10-
113[ ![ platform - android] ( https://img.shields.io/badge/platform-Android-3ddc84.svg?logo=android&style=for-the-badge )] ( https://www.android.com )
124[ ![ platform - ios] ( https://img.shields.io/badge/platform-iOS-000.svg?logo=apple&style=for-the-badge )] ( https://developer.apple.com/ios )
135
6+ [ ![ React Native] ( https://img.shields.io/badge/React%20Native-0.83.4-61DAFB?logo=react&style=for-the-badge )] ( https://reactnative.dev )
7+ [ ![ TypeScript] ( https://img.shields.io/badge/TypeScript-5.8.3-3178C6?logo=typescript&style=for-the-badge )] ( https://www.typescriptlang.org )
8+ [ ![ License] ( https://img.shields.io/badge/License-MIT-green?style=for-the-badge )] ( https://opensource.org/licenses/MIT )
9+
10+ [ ![ Unit Tests] ( https://img.shields.io/badge/Unit%20Tests-Passing-success?logo=github-actions&style=for-the-badge )] ( https://github.com/alejandro-technology/react-native-template/actions/workflows/unit-test.yml )
11+ [ ![ APK Build] ( https://img.shields.io/badge/APK%20Build-Ready-success?logo=android&style=for-the-badge )] ( https://github.com/alejandro-technology/react-native-template/actions/workflows/android-apk.yml )
12+ [ ![ iOS Build] ( https://img.shields.io/badge/iOS%20Build-Ready-success?logo=apple&style=for-the-badge )] ( https://github.com/alejandro-technology/react-native-template/actions/workflows/ios-build.yml )
13+
14+
1415A ** production-ready React Native starter** built with ** Clean Architecture** , ** TypeScript** , and ** AI-First principles** .
1516
1617Designed to help developers build ** scalable mobile applications** with a modular architecture, real-world examples, and preconfigured tooling.
@@ -25,6 +26,7 @@ Perfect for:
2526---
2627
2728## 🎥 Demo
29+
2830<p align =" center " >
2931 <img src =" ./assets/rnkit_review.gif " width =" 45% " />
3032</p >
@@ -37,7 +39,7 @@ Perfect for:
3739- ⚡ Zustand + React Query state management
3840- 💾 Data caching
3941- 📄 Forms with validations
40- - 🧰 Svg, Permissions, Image Picker
42+ - 🧰 Svg, Permissions, Image Picker
4143- ⚙️ Environment variables
4244- 🔐 Security storage (Secrets, Keychain)
4345- 🎨 Design System with theme tokens
@@ -70,7 +72,9 @@ This template will have a companion CLI to extract modules:
7072``` bash
7173npm init react-native-init-app
7274```
75+
7376or
77+
7478``` bash
7579bunx create-react-native-init-app
7680# or
@@ -80,6 +84,7 @@ npx create-react-native-init-app
8084# 🚀 Manual Installation
8185
8286## Prerequisites
87+
8388- Node.js (v22+ recommended)
8489- Ruby (for CocoaPods)
8590- JDK 17+
@@ -88,12 +93,14 @@ npx create-react-native-init-app
8893## Installation
8994
90951 . ** Clone the repository:**
96+
9197 ``` bash
9298 git clone https://github.com/alejandro-technology/react-native-template.git
9399 cd react-native-template
94100 ```
95101
961022. ** Install dependencies:**
103+
97104 ` ` ` bash
98105 npm install
99106 ` ` `
@@ -108,11 +115,13 @@ npx create-react-native-init-app
108115# # Running the App
109116
110117- ** Start Metro Bundler:**
118+
111119 ` ` ` bash
112120 npm start
113121 ` ` `
114122
115123- ** Run on iOS:**
124+
116125 ` ` ` bash
117126 npm run ios
118127 ` ` `
@@ -122,7 +131,6 @@ npx create-react-native-init-app
122131 npm run android
123132 ` ` `
124133
125-
126134# 📂 Project Structure
127135
128136The project follows a ** Modular Architecture** . Each feature is a self-contained module in ` src/modules/` containing its own layers:
143151```
144152
145153## 🧠 Module Anatomy (Clean Architecture)
154+
146155Each module (e.g., `src/modules/products/`) is divided into:
156+
1471571. **Domain:** Entities, Repository Interfaces, Errors (Pure TS, no React/Lib dependencies).
1481582. **Application:** Use Cases, State Management (Zustand/Query), Logic.
1491593. **Infrastructure:** API calls, Database implementation, Third-party adapters.
0 commit comments