🚀 SM CLI — Flutter Clean Architecture Generator

A powerful CLI tool to generate production-ready Flutter projects with clean architecture, multiple state management options, and feature-based structure.

---

📦 Installation

dart pub global activate sm_cli

Make sure Dart is in your PATH:

export PATH="$PATH":"$HOME/.pub-cache/bin"

---

✨ Features

• ⚡ Flutter project initializer with clean architecture
• 🧩 Feature-based folder structure (Data, Domain, Presentation)
• 🔄 Multiple state management — Riverpod, Bloc, GetX, Provider
• 🌐 API layer generator (Dio, interceptors, response wrapper)
• 🛣️ GoRouter integration with auto route generation
• 🎨 Theme setup (light + dark)
• 💾 Project config auto-saved (no need to specify state management every time)

---

🚀 Quick Start

# 1. Install
dart pub global activate sm_cli
# 2. Create project
sm init my_app
# 3. Generate feature
sm make feature my_app auth
# 4. Generate API layer
sm make api my_app
# 5. List features
sm list my_app
# 6. Runcd my_app && flutter run

---

📋 Commands

sm init <project_name>

sm init my_app
sm init my_app --riverpod
sm init my_app --bloc
sm init my_app --getx
sm init my_app --provider

sm make feature <project_name> <feature_name>

sm make feature my_app auth
sm make feature my_app home
sm make feature my_app profile

sm make api <project_name>

sm make api my_app

sm list <project_name>

sm list my_app

Prompts:

• Select State Management (Riverpod / Bloc / GetX / Provider)
• Enable GoRouter? (y/n)
• Enable Theme? (y/n)

Or use flags to skip prompts:

sm init my_app --riverpod
sm init my_app --bloc
sm init my_app --getx
sm init my_app --provider

---

sm make feature <project_name> <feature_name>

Generates a complete feature with clean architecture structure.

sm make feature my_app auth
sm make feature my_app home
sm make feature my_app profile

State management is auto-detected from project config — no need to specify every time.

---

sm make api <project_name>

Generates a complete API layer using Dio.

sm make api my_app

---

📁 Generated Structure

Project Structure

my_app/
├── lib/
│ ├── core/
│ │ ├── constants/
│ │ ├── network/
│ │ │ ├── dio_client.dart
│ │ │ ├── api_endpoints.dart
│ │ │ ├── response_wrapper.dart
│ │ │ ├── network_exceptions.dart
│ │ │ └── interceptors/
│ │ │ └── logging_interceptor.dart
│ │ ├── routes/
│ │ │ ├── app_router.dart
│ │ │ └── app_routes.dart
│ │ ├── theme/
│ │ │ └── app_theme.dart
│ │ └── utils/
│ ├── features/
│ │ └── auth/
│ └── shared/
├── .sm_cli_config
└── pubspec.yaml

Feature Structure — Riverpod / Provider

auth/
├── data/
│ ├── datasource/
│ │ └── auth_remote_datasource.dart
│ ├── models/
│ │ └── auth_model.dart
│ └── repository/
│ ├── auth_repository.dart
│ └── auth_repository_impl.dart
├── domain/
│ ├── entities/
│ │ └── auth_entity.dart
│ ├── repository/
│ │ └── auth_repository.dart
│ └── usecases/
│ └── auth_usecase.dart
└── presentation/
├── screens/
│ └── auth_screen.dart
├── providers/
│ └── auth_provider.dart
└── widgets/

Feature Structure — Bloc

auth/
└── presentation/
├── screens/
│ └── auth_screen.dart
├── bloc/
│ ├── auth_bloc.dart
│ ├── auth_event.dart
│ └── auth_state.dart
└── widgets/

Feature Structure — GetX

auth/
└── presentation/
├── screens/
│ └── auth_screen.dart
├── views/
│ └── auth_view.dart
├── controllers/
│ └── auth_controller.dart
├── bindings/
│ └── auth_binding.dart
└── widgets/

🔄 State Management

Feature	Riverpod	Bloc	GetX	Provider
State file	_provider.dart	_bloc.dart	_controller.dart	_provider.dart
Folder	providers/	bloc/	controllers/	providers/
Extra	—	_event, _state	_binding, _view	—
Package	flutter_riverpod	flutter_bloc	get	provider

---

🌐 API Layer

Generated by sm make api:

// dio_client.dart — singleton Dio instancefinal client =DioClient().dio;
// api_endpoints.dart — all your endpointsclassApiEndpoints {
staticconst baseUrl ="https://api.example.com";
staticconst login ="/login";
}

---

🛣️ Routing

Routes are auto-generated and updated when you run sm make feature:

// app_routes.dart — auto updatedclassAppRoutes {
staticconst home ='/';
staticconst auth ='/auth'; // auto added by sm make feature
}
// app_router.dart — auto updatedfinal appRouter =GoRouter(
routes: [
GoRoute(
path:AppRoutes.auth, // auto added by sm make feature
builder: (context, state) =>constAuthScreen(),
),
],
);

---
## 🎨 Theme
Light and dark theme pre-configured with Material 3:
```dart
MaterialApp.router(
theme: AppTheme.lightTheme,
darkTheme: AppTheme.darkTheme,
routerConfig: appRouter,
);

---

📋 All Flags

sm init <name># Interactive setup
sm init <name> --riverpod # Skip prompt, use Riverpod
sm init <name> --bloc # Skip prompt, use Bloc
sm init <name> --getx # Skip prompt, use GetX
sm init <name> --provider # Skip prompt, use Provider
sm --help # Show help
sm --version # Show version

---

🆚 Why SM CLI?

	SM CLI	mason	very_good_cli
Clean Architecture	✅	❌	✅
Multiple state mgmt	✅	❌	❌ (Bloc only)
Auto route update	✅	❌	❌
API layer generator	✅	❌	❌
Project config	✅	❌	❌
Interactive CLI	✅	✅	✅

---

🐛 Issues & Feedback

Found a bug or have a suggestion? 👉 Open an issue

---

📄 License

MIT License — see LICENSE