founder_code_cli 0.2.0-beta.4

An enterprise-grade Flutter CLI for generating production-ready applications following Founder Code Standards and Clean Architecture.

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