Flut### 🎯 Super Simple Workflow
- Right-click on your
lib
folder → Select "Create Feature"
- Right-click on any feature folder → Select "Add Use Case"
- That's it! Your Clean Architecture code is ready to use.
🚀 What You Getture Generator - Clean Architecture Made Easy
A VS Code extension that makes creating Clean Architecture features for Flutter/Dart projects as simple as a right-click. Generate complete features and use cases instantly with smart dependency management.
✨ Quick Start - Right-Click to Create!
� Super Simple Workflow
- Right-click on your
lib
folder → Select "Create Feature"
- Right-click on any feature folder → Select "Add Use Case"
- That's it! Your Clean Architecture code is ready to use.
� What You Get
- ✅ Complete Clean Architecture structure (data, domain, presentation layers)
- ✅ All necessary files generated automatically
- ✅ Dependencies installed only when needed
- ✅ Service locator setup handled for you
- ✅ Tree view to visualize your project structure
📋 Prerequisites
- VS Code 1.74.0+
- Flutter/Dart project with
pubspec.yaml
- That's it! No manual CLI installation needed.
🔧 Installation
From VS Code Marketplace
- Open Extensions (
Ctrl+Shift+X
)
- Search "Feature Generator"
- Click "Install"
From VSIX File
- Extensions panel → "..." → "Install from VSIX..."
- Select the
.vsix
file
🎮 How to Use
🆕 Create Your First Feature
- Right-click on your project's
lib
folder in VS Code Explorer
- Select "Create Feature" from the context menu
- Enter feature name (e.g., "auth", "profile", "dashboard")
- ✅ Done! Your feature structure is created automatically
➕ Add Use Cases to Features
- Right-click on any feature folder (e.g.,
lib/features/auth/
)
- Select "Add Use Case" from the context menu
- Enter use case name (e.g., "login", "signup", "logout")
- ✅ Done! All related files are generated
🔍 View Your Project Structure
- Check the "Features" tree view in the Explorer panel
- Click on any file to open it
- See all your features, use cases, and layers organized
🛠️ Alternative Commands (Optional)
You can also use the Command Palette (Ctrl+Shift+P
):
Feature Generator: Create Feature
Feature Generator: Add Use Case
Feature Generator: Validate Project
🏗️ What Gets Generated
📁 Complete Feature Structure
When you create a feature, you get this clean structure:
lib/features/your_feature/
├── data/
│ ├── data_sources/ # API and local data handling
│ ├── models/ # Data models and DTOs
│ └── repositories/ # Repository implementations
├── domain/
│ ├── repositories/ # Repository contracts
│ └── use_cases/ # Business logic
└── presentation/
├── controllers/ # State management
├── views/ # UI screens
└── widgets/ # Reusable UI components
📄 Use Case Files Generated
When you add a use case (e.g., "login"), you automatically get:
- Use Case:
domain/use_cases/login_use_case.dart
- Business logic
- Repository Interface:
domain/repositories/login_repository.dart
- Contract
- Repository Implementation:
data/repositories/login_repo.dart
- Implementation
- Data Source:
data/data_sources/login_data_source.dart
- API/Local data
- Model:
data/models/login_feature_model.dart
- Data structures
🔧 Smart Dependency Management
The extension automatically handles:
- ✅ Installing required packages (
get_it
, dartz
, etc.) on first use
- ✅ Setting up service locator (
core/service_locator.dart
)
- ✅ No manual setup required!
📊 Features Overview
🌳 Features Tree View
- Hierarchical view of all your features in the Explorer panel
- Click any file to open it instantly
- See use cases organized by feature
- Navigate between data, domain, and presentation layers
🔍 Project Validation
- Check your project structure health
- Get recommendations for improvements
- One-click fixes for common issues
⚙️ Smart Configuration
- Auto-detects Flutter/Dart projects
- Configurable settings for your workflow
- No manual CLI setup required
🔧 Troubleshooting
❌ Common Issues & Solutions
"Feature not created" or "Command failed"
- Check your project: Make sure you have a
pubspec.yaml
file
- Try Command Palette: Use
Ctrl+Shift+P
→ "Feature Generator: Create Feature"
- Check Output: View → Output → Select "Feature Generator" from dropdown
Right-click options not showing
- Restart VS Code after installing the extension
- Refresh Explorer: Right-click in Explorer → Refresh
- Check folder: Make sure you're right-clicking on
lib
or feature folders
Permission or file creation issues
- Check folder permissions in your project directory
- Close and reopen your project folder
- Try running VS Code as administrator (if on Windows)
🐛 Still Having Issues?
- Check Output Panel: View → Output → "Feature Generator"
- Report Issues: GitHub Issues
- Include: VS Code version, OS, error messages, and output logs
🤝 Contributing & Support
💡 Feature Requests & Bug Reports
🔗 Useful Links
📄 License
MIT License - see LICENSE file for details.
🎯 Made for Flutter developers who love Clean Architecture
⭐ If this extension helps you, please star the repo and leave a review!