https://github.com/machinelearningprodigy/flappost
A Flutter Clean Architecture Boilerplate 🚀 designed for scalable, maintainable, and testable app development. It follows Clean Architecture principles with BLoC for state management, ensuring a modular and structured codebase. 🎯
https://github.com/machinelearningprodigy/flappost
bloc flutter hive supabase ui widgets
Last synced: about 1 month ago
JSON representation
A Flutter Clean Architecture Boilerplate 🚀 designed for scalable, maintainable, and testable app development. It follows Clean Architecture principles with BLoC for state management, ensuring a modular and structured codebase. 🎯
- Host: GitHub
- URL: https://github.com/machinelearningprodigy/flappost
- Owner: machinelearningprodigy
- Created: 2025-02-13T05:20:35.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-02-27T14:25:38.000Z (11 months ago)
- Last Synced: 2025-02-27T20:21:54.549Z (11 months ago)
- Topics: bloc, flutter, hive, supabase, ui, widgets
- Language: C++
- Homepage:
- Size: 389 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🚀 Flutter Clean Architecture Boilerplate
Welcome to your **Flutter Clean Architecture** project! 🎯 This repository follows the **Clean Architecture** principles to ensure scalability, maintainability, and testability.
## 📂 Folder Structure
```
lib/
│── core/ # ⚙️ Core functionalities (errors, themes, secrets, usecases)
│── features/
│ ├── auth/ # 🔐 Authentication module
│ │ ├── data/ # 📦 Data layer (datasources, repositories)
│ │ ├── domain/ # 📜 Business logic layer (use cases, repository contracts)
│ │ ├── presentation/ # 🎨 UI layer (Bloc, Pages, Widgets)
│── main.dart # 🏁 Entry point
```
## 🏗️ Clean Architecture Overview
This project follows **Robert C. Martin's** Clean Architecture principles:
- **Presentation Layer (UI) 🎨** → Manages user interactions.
- **Domain Layer (Business Logic) 📜** → Defines business rules and use cases.
- **Data Layer (Repositories & Data Sources) 📦** → Handles API calls, database, etc.
## 🔌 Tech Stack
- **Flutter** 🐦
- **Dart** 🎯
- **BLoC (Business Logic Component) Pattern** 🏛️
- **Dependency Injection** 💉
- **REST API Integration** 🌐
- **Firebase Authentication** 🔥 (if applicable)
## 🚀 Getting Started
### 1️⃣ Clone the Repository
```sh
git clone https://github.com/machinelearningprodigy/FlapPost.git
cd FlapPost
```
### 2️⃣ Install Dependencies
```sh
flutter pub get
```
### 3️⃣ Run the App 🚀
```sh
flutter run
```
## 🛠️ Features
- ✅ Modular Clean Architecture
- ✅ State Management with BLoC
- ✅ Scalable and Maintainable Code
- ✅ Theme & Error Handling
## 🤝 Contributing
Feel free to open issues and contribute! 🎉
---
Made with ❤️ using Flutter!
```