Clean Flutter Architecture, Clean Gen-ToolPlus

Contact: richardchalger@gmail.com

How To Use #

First add the package to your pubspec.yaml:

dependencies:
  clean_gen_tool_plus: ^1.0.0

Or run the following command in your terminal: With Dart:

  dart pub add clean_gen_tool_plus

With Flutter:

  flutter pub add clean_gen_tool_plus

Import it

  import 'package:clean_gen_tool_plus/clean_gen_tool_plus.dart';

Create a new file named gen_tool.dart in the lib directory of your Flutter project. and add the following code to it:

import 'package:clean_gen_tool_plus/clean_gen_tool_plus.dart';

 void main() async {
   await CleanGenTool.generate();
 }

Then run the generator tool to generate the necessary files and structure:

  dart run lib/gen_tool.dart

Documentation: #

Clean Architecture #

This project is a base Flutter Clean Architecture template demonstrating best practices in project structure, state management, and scalable app development.

It includes:

• A sample Category screen
• A sample Login screen
• Implementation of Bloc/Cubit for state management
• Robust error handling (network errors, failures, exceptions)
• Well-structured repository pattern
• Base Repository for clean code implementation
• Well-structured network pattern
• PrettyDioLogger for the best dio logging for debuggers
• Offline Builder in case internet went off
• A ready to use General Layer to help use in the app :
  • constants / routing / theme / env settings / offline builder / shared preference

The project is built following the Clean Architecture principles, broken down into three main layers:

• business_layer – Manages state using Cubits (Bloc)
• data_layer – Handles models, networking, and repositories
• general_layer – Contains constants, services, utilities, routing, and more

Structure #

Structure A-Conceptual
lib/
├── core/
│   ├── business_layer/
│   ├── data_layer/
│   └── general_layer/
├── features/
│   ├── onboarding/
│   └── splash/
├── app.dart
├── app_bloc_observer.dart
└── main.dart

Structure B - Current
lib/
├── core/
│   ├── business_layer/
│   │   └── cubit/
│   │       ├── category/
│   │       ├── locale/
│   │       ├── login/        
│   │       └── theme/
│   │   └── bloc/
│   │       └── login/
│   ├── data_layer/
│   │   ├── errors/
│   │   ├── models/
│   │   │   └── category/
│   │   ├── network/
│   │   └── repository/
│   │       ├── base/
│   │       └── category/
│   └── general_layer/
│       ├── constants/
│       ├── extensions/
│       ├── routing/
│       ├── services/
│       ├── theme/
│       └── utils/
├── features/
│   ├── home/
│   │   └── presentation/
│   │       └── screens/
│   ├── login/               
│   │   └── presentation/
│   │       └── screens/
│   ├── onboarding/
│   │   └── presentation/
│   │       └── screens/
│   └── splash/
│       └── presentation/
│           └── screens/
└── generated/

Getting Started #

flutter pub get
flutter run

For the use of Git : (Main Git Commands) #

git init
git add .
git remote add origin 'Repository Url'
git commit -m 'Type : Message'

git pull / git fetch origin
git push origin 'branchName'
git push origin 'branchName':'branchName2' --force

git status
git log
git branch
git merge 'branchName'

git checkout 'branchName'
git checkout -b 'branchName'

To generate a new structure into a .txt file #

dart lib/generate_structure.dart > structure.txt

Credits #

Built with ❤️ Special thanks to Abdullah Essam for the inspiration and guidance.