Flutter Clean Architecture

Elevate your Flutter development with a professional folder structure based on Clean Architecture principles. Scaffold entire projects or individual features in seconds, ensuring your codebase remains scalable, testable, and maintainable.

💎 Premium Features

Flutter Clean Architecture is a premium extension available for a one-time fee of €1.99. Your support helps maintain the tool and ensures lifetime updates.

Get Your License Key

Demo of Flutter Clean Architecture Scaffolding

🔓 How to Unlock

Purchase a license key from the link above.
Open VS Code.
Press Cmd + Shift + P (Mac) or Ctrl + Shift + P (Windows).
Type "Unlock".
Select "Flutter Clean Architecture: Unlock Full Version".
Paste your key.

🚀 Key Features

Full Project Initialization: Instantly scaffold the standard Clean Architecture structure (core, features, injection_container, .env).
Smart Feature Scaffolding: Create new features with data, domain, and presentation layers automatically.
State Management Integration: Supports Bloc, Cubit, or your own Custom state management folder during feature creation.
Boilerplate Support: Initialize your project using your own custom boilerplate code.
Highly Configurable: Customize folder names for every layer of your architecture to match your team's naming conventions.
Context-Aware Commands: Right-click directly in the File Explorer to initialize folders or add features exactly where you need them.

🛠 Commands

Command	Title	Description
`Flutter Clean Architecture: Init`	Init Project	Scaffolds the basic Clean Architecture structure in the selected folder.
`Flutter Clean Architecture: Init from Boilerplate`	Init from Boilerplate	Copies your custom boilerplate folder into the project.
`Flutter Clean Architecture: New Feature`	New Feature	Scaffolds a new feature with data, domain, and presentation layers.
`Flutter Clean Architecture: Set Boilerplate Path`	Set Boilerplate Path	Select the folder to use as your custom boilerplate source.
`Flutter Clean Architecture: Open Settings`	Open Settings	Quickly access extension settings.

📁 Architecture Structure

The extension follows the classic Clean Architecture pattern:

lib/
├── core/
│   ├── error/
│   ├── usecases/
│   └── util/
├── features/
│   └── [feature_name]/
│       ├── data/
│       │   ├── datasources/
│       │   ├── models/
│       │   └── repositories/
│       ├── domain/
│       │   ├── entities/
│       │   ├── repositories/
│       │   └── usecases/
│       └── presentation/
│           ├── [bloc/cubit/custom]/
│           ├── pages/
│           └── widgets/
├── injection_container.dart
└── main.dart

⚙️ Configuration

You can customize the extension via VS Code Settings:

flutterCleanArchitecture.boilerplatePath: Path to your custom boilerplate code.
flutterCleanArchitecture.flutterPath: Custom path to the Flutter executable (auto-detected by default).
flutterCleanArchitecture.feature_data: Name for the data layer folder.
flutterCleanArchitecture.feature_domain: Name for the domain layer folder.
flutterCleanArchitecture.feature_presentation: Name for the presentation layer folder.
...and more for specific sub-folders like entities, models, usecases, etc.

🚦 Getting Started

Initialize Project: Right-click on your project root or lib folder and select Init Flutter Clean Architecture.
Add a Feature: Right-click on the features folder and select New Feature.
Customization: Go to Settings > Extensions > Flutter Clean Architecture to tweak the folder naming or set your boilerplate path.

❓ Troubleshooting

🔴 IMPORTANT: If you experience any issues with the extension (e.g. "command not found" errors) immediately after installation, please restart your laptop. This resolves environment path issues in some VS Code setups.

Happy Coding! 🚀

Flutter Clean Architecture Pro

realportuguesedev