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.

📖 Table of Contents #

• Introduction
• Features
• Installation
• Requirements
• Quick Start
• Architecture
• Folder Structure
• Project Commands
• Utility Commands
• Upgrade System
• Dependency Registry
• FAQ
• Roadmap
• Troubleshooting
• Version History

🌟 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 #

1. Create a project:

   foundercode create my_app --org com.founder.code
   

2. Generate a feature:

   foundercode feature profile
   

3. 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 #

1. Open lib/src/core/services/package_registry.dart.
2. Add your package to the approvedPackages map.
3. 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).

📄 License #

MIT License - Copyright (c) 2026 Shubham Patwa | Founder Code