https://github.com/ecrindigital/expo-starter-auth-nativewind
Clean and reliable starter project with Expo React Native, with Authentication and NativeWind
https://github.com/ecrindigital/expo-starter-auth-nativewind
cleanarchitecture expo expo-template firebase nativewind react-native tailwindcss
Last synced: 3 months ago
JSON representation
Clean and reliable starter project with Expo React Native, with Authentication and NativeWind
- Host: GitHub
- URL: https://github.com/ecrindigital/expo-starter-auth-nativewind
- Owner: ecrindigital
- License: mit
- Created: 2025-02-24T22:38:48.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-16T19:17:21.000Z (over 1 year ago)
- Last Synced: 2025-03-16T20:29:58.890Z (over 1 year ago)
- Topics: cleanarchitecture, expo, expo-template, firebase, nativewind, react-native, tailwindcss
- Language: TypeScript
- Homepage:
- Size: 478 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ๐ฑ Expo Starter Auth NativeWind
A modern, type-safe starter template for building cross-platform mobile applications with Expo, featuring authentication and clean architecture principles.
## ๐ Stack
- [**Expo**](https://docs.expo.dev/) - Universal React platform
- [**Expo Router**](https://docs.expo.dev/router/introduction/) - File-based routing system
- [**NativeWind**](https://www.nativewind.dev/) - Tailwind CSS for React Native
- [**TypeScript**](https://www.typescriptlang.org/) - Type safety
- [**Clean Architecture**](https://blog.cleancoder.com/uncle-bob/2012/08/13/the-clean-architecture.html) - Scalable and maintainable project structure
## โจ Features
- ๐ **Authentication Ready** - Secure authentication flow with proper state management
- ๐จ **Modern UI** - Beautiful, responsive UI with NativeWind (Tailwind CSS)
- ๐ฑ **Cross Platform** - Works seamlessly on iOS, Android, and Web
- ๐๏ธ **Clean Architecture** - Domain-driven design with clear separation of concerns
- ๐ **File-based Routing** - Intuitive routing with Expo Router
- ๐ช **Type Safety** - Full TypeScript support
- ๐ **State Management** - Efficient and predictable state handling
- ๐งช **Testing Setup** - Ready for implementing your test suite
## ๐ Quick Start
### Prerequisites
- [Node.js](https://nodejs.org/en/) (v18+ recommended)
- [Expo CLI](https://docs.expo.dev/workflow/expo-cli/)
- iOS/Android Simulator or physical device
### Installation
```bash
# Clone the repository
git clone https://github.com/ecrindigital/expo-starter-auth-nativewind.git
# Navigate to the project directory
cd expo-starter-auth-nativewind
# Install dependencies
npm install
# or
yarn install
# Start the development server
npm start
# or
yarn start
```
## ๐ Project Structure
WIP
## ๐ ๏ธ Development
### Environment Variables
WIP
### Running on Different Platforms
```bash
# iOS
npm run ios
# or
yarn ios
# Android
npm run android
# or
yarn android
# Web
npm run web
# or
yarn web
```
## ๐ Notes
- This template follows Clean Architecture principles for better scalability and maintainability
- Authentication flow is implemented using industry best practices
- NativeWind v4 is configured for styling with Tailwind CSS
- The project structure is optimized for large-scale applications
## ๐ค Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
## ๐ License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.