An open API service indexing awesome lists of open source software.

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

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.



Supports Expo iOS
Supports Expo Android
Supports Expo Web

## ๐Ÿ“š 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.