flutter_enterprise_cli 1.1.0

Enterprise-grade Flutter CLI tool for generating production-ready project scaffolding with clean architecture, multi-environment flavors, and CI/CD automation.

flutter_enterprise_cli

Enterprise-grade Flutter CLI tool for generating production-ready
project scaffolding with clean architecture, multi-environment flavors,
and CI/CD automation.

---

✨ Features

• 🏗 Clean Architecture folder structure
• 🔀 Android flavor automation (dev / prod)
• 🍎 iOS entrypoint configuration support
• 🚀 GitHub Actions CI/CD template
• 📦 Dev APK + Prod AAB builds
• 📱 Dev & Prod IPA generation (unsigned by default)
• 🛑 Prevents nested project creation
• 🛡 Safe project overwrite protection
• ⚙ CLI-based architecture generation
• 🌍 Cross-platform support (Windows / macOS / Linux)

---

🚀 Installation

Activate globally:

dart pub global activate flutter_enterprise_cli

---

⚙ If Command Not Found

After activation, if you see:

flutter_enterprise_cli: command not found

You need to add Dart Pub Cache to your system PATH.

🪟 Windows

Add this to Environment Variables:

%LOCAL APPDATA%\Pub{=tex}\Cache{=tex}\bin{=tex}

Then restart your terminal.

🍎 macOS / 🐧 Linux

Add this line to your ~/.zshrc or ~/.bashrc:

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

Then run:

source ~/.zshrc

After that, the CLI will work globally:

flutter_enterprise_cli create my_app

---

🛠 Usage

Create a new enterprise project:

flutter_enterprise_cli create my_app

Advanced Usage

flutter_enterprise_cli create my_app --state bloc --flavors dev,prod

Add CI/CD to Existing Project

Run inside your Flutter project:

flutter_enterprise_cli ci

Configure Flavors in Existing Project

Run inside your Flutter project:

flutter_enterprise_cli flavors

---

🧠 Available State Management Options

• bloc (default)
• riverpod

---

📂 Generated Project Structure

lib/
 ├── core/
 │    ├── config/
 │    ├── network/
 │    ├── services/
 │    ├── constants/
 │    └── utils/
 ├── data/
 ├── domain/
 ├── presentation/
 ├── routes/
 ├── app/
 │    ├── app.dart
 │    └── bootstrap.dart
 ├── main_dev.dart
 └── main_prod.dart

---

🔀 Android Flavors

Run example:

flutter run --flavor dev -t lib/main_dev.dart

---

🍎 iOS Support

• Generates dev.xcconfig and prod.xcconfig
• Supports IPA generation in CI
• Uses unsigned IPA by default (--no-codesign)
• Signed IPA supported via GitHub Secrets

---

🚀 CI/CD Included

Generated project includes:

• Android build (APK + AAB)
• iOS build (IPA)
• Artifact upload
• Flutter analyze step

Workflow file:

.github/workflows/flutter_ci.yml

---

⚙ Requirements

• Flutter 3.35.5+
• Dart SDK 3.5+
• macOS required for iOS builds
• GitHub Actions for CI/CD

---

📄 License

MIT License