🚀 FEX Intelligence (Flutter Engine-X)

The God-Level AI Toolkit for Modern Flutter Architectures

FEX (Flutter Engine-X) is an enterprise-grade CLI that bridges the gap between rapid prototyping and extreme software reliability. It doesn't just scaffold boilerplate code; it orchestrates AI to audit, heal, evolve, and optimize your entire development lifecycle.

🌟 Why FEX?

90% of CLIs stop at generating files. FEX continues where others end. With its integration to Google's Gemini AI, FEX acts as your virtual Senior Developer, Security Researcher, and QA Tester right inside your terminal.

⚙️ Quick Start

Install globally via pub.dev:

dart pub global activate fex_intelligence

Activate the AI Engine (Required for God-Level commands):

fex config --key YOUR_GEMINI_API_KEY

🧰 The FEX Arsenal (Command Reference)

FEX contains over 25+ powerful commands categorized by their impact.

🧠 God-Level Intelligence

Command	Description
`fex review`	Spawns an AI Team (QA, Security, Architect, PM) to review your codebase.
`fex evolve --from getx --to riverpod`	AI-driven architecture migration. Rewrites state management logic automatically.
`fex refactor -f <file>`	Targets a specific file and autonomously patches bad code and smells.
`fex compliance`	Scans codebase for architectural consistency and enterprise compliance.

🛡️ DevOps & Security

Command	Description
`fex log`	Injects the VS Code Live Network Inspector into your project.
`fex pentest`	Autonomous Z3 security scanning to detect leaked secrets and weak HTTP rules.
`fex qa`	Spawns a virtual QA Agent to analyze logical flaws.
`fex cicd`	Automatically generates GitHub Actions / GitLab CI workflows.
`fex release <patch/minor/major>`	Intelligent version bumping and changelog generation.
`fex sign`	Automatically configures Android Keystore & App Signing.
`fex env setup`	Sets up secure environment variables (.env).

⚡ Performance & Maintenance

Command	Description
`fex monitor`	Connects to Live Performance Surgeon.
`fex optimize`	Scans and provides extreme runtime optimization tips.
`fex doctor`	Checks dependency health (finds abandoned/deprecated packages).
`fex perf`	Analyzes rendering and rebuild performance.
`fex size`	App size analyzer to detect heavy assets/packages.
`fex migrate`	Assists with Flutter SDK breaking changes migration.

🛠️ Generators & Automation

Command	Description
`fex init`	Bootstraps a fresh enterprise-ready Flutter project structure.
`fex generate crud -n User`	Generates Repository, Service, Model, and Controller logic.
`fex generate model -n User`	Generates Freezed/JsonSerializable models from JSON.
`fex generate flavor init`	Automatically sets up dev/stag/prod flavors.
`fex ui --type login`	Generates beautiful predefined UI screens.
`fex l10n init`	Initializes App Localization support.
`fex localize`	Uses AI to automatically translate `.arb` files to multiple languages.
`fex figma --token <t> --file <f>`	Syncs Figma design tokens directly to Flutter themes.
`fex asset sync`	Generates a safe R.dart class for all your assets.
`fex deeplink check`	Validates your iOS/Android deep-link configurations.
`fex rename`	Safely renames the entire Flutter package name and Android/iOS bundles.
`fex permission`	Automatically adds necessary Android/iOS permissions.
`fex icon`	Generates app icons from a single source image.
`fex splash`	Generates a native splash screen.

📖 Full Documentation

To view interactive tutorials, the real-time terminal showcase, and advanced setup guides, visit the official FEX Documentation Portal.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.