ixartz/React-Native-Boilerplate

Boilerplate and Starter for React Native, Expo, NativeWind and TypeScript

🚀 Boilerplate and Starter for React Native, Expo, NativeWind and TypeScript ⚡️ Made with developer experience first: React Native, Expo, TypeScript, ESLint, Prettier, Husky, Lint-Staged, Jest, Detox, VSCode, NativeWind.

Sponsors

Add your logo here

Features

Developer experience first:

• ⚡ Expo for mobile development
• ⚛️ React Native for building native apps using React
• 🔥 Type checking TypeScript
• 💎 Integrate with NativeWind, Tailwind CSS for React Native
• 📁 File-based routing with Expo Router
• 📏 Linter with ESLint
• 💖 Code Formatter with Prettier
• 🦊 Husky for Git Hooks
• 🚫 Lint-staged for running linters on Git staged files
• 🦺 Unit Testing with Jest and React Testing Library
• 🧪 E2E Testing with Detox
• 💡 Absolute Imports using @ prefix
• 🗂 VSCode configuration: Settings, Tasks and extension for PostCSS, ESLint, Prettier, TypeScript, Jest

Nextless.js SaaS Boilerplate

Build your SaaS product faster with React SaaS Boilerplate.

Requirements

• Node.js 14+ and npm
• iOS Simulator
• Android Studio Emulator

Getting started

Run the following command on your local environment (for example, in Warp):

git clone --depth=1 https://github.com/ixartz/React-Native-Boilerplate.git my-project-name
cd my-project-name
npm install

Then, you can run locally in development mode with live reload:

npm run dev:ios
# Or
npm run dev:android

This will open the app in the iOS simulator or Android emulator.

Testing

Testing is an important part of the development process and often the neglected one. This starter code comes up with Jest and React Testing Library for unit testing and Detox for E2E testing.

Unit Testing

To run the unit tests, run the following command (for example, in Warp):

npm run test

E2E Testing

To run the E2E tests, you first need to run the following command:

npm run e2e:prepare # Only need to run once

Then, you can run the following command to run the E2E tests:

npm run e2e:ios
# Or
npm run e2e:android

VSCode information (optional)

If you are VSCode users, you can have a better integration with VSCode by installing the suggested extension in .vscode/extension.json. The starter code comes up with Settings for a seamless integration with VSCode. The Debug configuration is also provided for frontend and backend debugging experience.

With the plugins installed on your VSCode, ESLint and Prettier can automatically fix the code and show you the errors. Same goes for testing, you can install VSCode Jest extension to automatically run your tests and it also show the code coverage in context.

Pro tips: if you need a project wide type checking with TypeScript, you can run a build with Cmd + Shift + B on Mac.

Contributions

Everyone is welcome to contribute to this project. Feel free to open an issue if you have question or found a bug. Totally open to any suggestions and improvements.

License

Licensed under the MIT License, Copyright © 2023

See LICENSE for more information.

Sponsors

Add your logo here

Made with ♥ by CreativeDesignsGuru