Founder Code CLI 🚀

The Ultimate Enterprise-Grade Flutter Scaffolding Tool.

Founder Code CLI (foundercode) is a professional-grade command-line interface designed to generate production-ready Flutter applications following strict Clean Architecture, a custom Responsive Engine, and hardened Infrastructure modules.

🌟 Introduction

Stop wasting time on boilerplate. Founder Code CLI generates a high-quality, scalable, and maintainable foundation for your Flutter apps in seconds. It enforces enterprise standards that ensure your project stays clean as it grows.

⚡ Features

✅ Clean Architecture: Automatic 10-folder slice per feature.
✅ Smart Networking: Dio-based service with SSE, WebSockets, and automatic error mapping.
✅ Responsive Engine: Dynamic scaling for mobile, tablet, and desktop (375x812 reference).
✅ Hardened Infrastructure: Pre-configured DI (GetIt), Routing (GoRouter), and Theme (Material 3).
✅ Unified Storage: Combined SharedPreferences and SecureStorage repository.
✅ Auth Ready: Generates a fully functional Authentication module.
✅ Developer Experience: Advanced tools like doctor, validate, and repair.
✅ Zero-Error Guarantee: Every generated project passes flutter analyze with 0 issues.

🛠 Installation

dart pub global activate founder_code_cli

Verify Installation

foundercode --version

📋 Requirements

Flutter SDK: ^3.10.0
Dart SDK: ^3.0.0
OS: Windows, macOS, or Linux

🚀 Quick Start

Create a project:

foundercode create my_app --org com.founder.code

Generate a feature:
```
foundercode feature profile
```

Generate a screen:

foundercode screen profile_settings --feature profile

🏗 Architecture

Founder Code CLI strictly follows Clean Architecture combined with Feature-Driven Development.

lib/
 ├── app/             # App Orchestration (DI, Router, Theme)
 ├── core/            # Enterprise Kernel (Infrastructure)
 │    ├── constants/  # Design Tokens & Keys
 │    ├── network/    # Resilient I/O (Dio, SSE, Sockets)
 │    ├── services/   # Background Services (Storage, Permissions)
 │    ├── widgets/    # Atomic UI Components
 │    ├── shared/     # Domain-agnostic Utilities & Models
 │    └── theme/      # Material 3 Engine
 ├── features/        # Business Domain Slices
 │    └── <feature>/
 │         ├── data/        # Datasource, Models, Repositories
 │         ├── domain/      # Entities, UseCases
 │         └── presentation/# Providers, Screens, Widgets, Routes
 └── main.dart        # Entry Point

💻 Project Commands

`foundercode create <name>`

Initializes a new enterprise Flutter project.

Example: foundercode create my_app --org com.company
Generated: Core kernel, Auth module, and GoRouter config.

`foundercode feature <name>`

Generates a 10-folder Clean Architecture slice inside lib/features/.

Generated: data/, domain/, presentation/ and all sub-folders.

`foundercode screen <name>`

Scaffolds a new responsive screen.

Arguments: --feature <feature> (Optional)

`foundercode model <name>`

Generates a data model with fromJson and toJson.

Arguments: --feature <feature> (Optional)

`foundercode widget <name>`

Generates a reusable UI component.

Arguments: --stateful (Flag)

`foundercode assets`

Generates the Assets reference class.

Arguments: --watch (Flag)

🛠 Utility Commands

`foundercode doctor`

Analyzes your environment (Flutter, Dart, Git, Java) to ensure you are ready for development.

`foundercode validate`

Performs a deep health check of your project structure and runs the static analyzer.

`foundercode repair`

Attempts to automatically fix common project issues by running clean, pub get, and dart fix.

`foundercode clean`

Deep cleans the project by removing build/, .dart_tool/, and standard Flutter clean.

🔝 Upgrade System

`foundercode upgrade`

Performs a full project analysis and upgrades core modules to the latest Founder Code Standard.

`foundercode upgrade --check`

Dry-run analysis of available dependency and CLI updates.

`foundercode upgrade --apply`

Safely applies dependency upgrades and validates the project with dart analyze.

🛠 Dependency Registry

Founder Code CLI uses a Centralized Dependency Registry to ensure compatible package versions.

Adding New Packages

Open lib/src/core/services/package_registry.dart.
Add your package to the approvedPackages map.
The CLI will now automatically detect and inject this version.

❓ FAQ

Q: Can I use it on existing projects?
A: Yes! Utility commands like validate and doctor work anywhere, and generators work if you follow the lib/features structure.

🗺 Roadmap

foundercode add hive: Hive DB plugin.
foundercode add firebase: Firebase automation.
Comprehensive unit test generator.

📜 Version History

0.2.0-beta.4: DX Update: Added doctor, validate, repair, clean. Improved upgrade.
0.2.0-beta.3: Added Enterprise Upgrade System.
0.2.0-beta.2: Architecture refactor (shared -> core).