🚀 Dengoo Kit

Pub Version Dart SDK License: MIT Style: Pedantic

The Ultimate DevOps CLI for Flutter Engineers. Automate your workflow, localize in seconds, and deploy with confidence.

⚡️ Why Dengoo Kit?

Dengoo Kit transforms your terminal into a DevOps superpower. Stop writing manual scripts for Asset Management, Localization, or Deployment.

  • 🪄 Super Easy Integration: One command to auto-configure VS Code tasks and keybindings.
  • 🌍 Magic Localization: Auto-detect strings in any file and translate them instantly.
  • 🚀 Automated Deployment: Interactive Android builds & iOS Git tagging in seconds.
  • 🏗️ Enterprise Standard: Generate Clean Architecture features & "Pro" project setups with a single CLI call.

📥 Installation

Install globally from pub.dev:

dart pub global activate dengoo_kit

🪄 Quick Start (VS Code Magic)

Turn any Flutter project into a Dengoo Super-Project in one step.

  1. Open your project terminal.
  2. Run: 
    dengoo_kit init
  3. That's it! You now have a .vscode/tasks.json supercharged with Dengoo commands.

🎮 How to Use

  • Run Tasks: Press Ctrl + Shift + P -> Type Run Task -> Select any Dengoo command.
  • Magic Key (Localization):
    • Mac: Cmd + Alt + L
    • Windows: Ctrl + Alt + L
    • Result: Instantly localizes all strings in your open file! 🤯

🔥 Features & Commands

1. 🏗️ Setup & Architecture

Start your projects right with professional templates and packages.

Command Description
dengoo_kit setup Pro Setup: Installs core packages (bloc, dio, easy_localization) & applies enterprise template.
dengoo_kit create feature <name> Clean Arch: Generates Data, Domain, and Presentation layers for a new feature.
dengoo_kit set app-name <name> Rename: Updates App Name on Android & iOS.
dengoo_kit set bundle-id <id> Bundle ID: Updates Bundle ID/Package Name on Android & iOS.

2. 🌍 Localization (The Magic Part)

Never manually edit .json files again.

Command Description
dengoo_kit loc file <path> Auto-Magic: Scans a Dart file, extracts strings, translates to Ar/En, & refactors code.
dengoo_kit loc add <key> <en> <ar> Quick Add: Adds a new key to both JSON files & regenerates code.
dengoo_kit loc cleanup Cleanup: Scans project, finds unused keys, and removes them from JSONs.
dengoo_kit loc gen Generate: Runs easy_localization:generate wrapper.

3. 🎨 Asset Management

Keep your assets/ folder clean and optimized.

Command Description
dengoo_kit assets cleanup Smart Clean: Scans code for asset usage & deletes unused files (with auto-backup).
dengoo_kit assets icons Icons: Generates Launcher Icons (wrapper for flutter_launcher_icons).
dengoo_kit assets splash Splash: Generates Native Splash (wrapper for flutter_native_splash).

4. 🚀 Deployment & CI/CD

Ship faster with automated build pipelines.

Command Description
dengoo_kit deploy android Interactive Build: Bumps version, manages keystores, & builds App Bundle (.aab).
dengoo_kit deploy ios <version> Git Release: Auto-tags commit and pushes release tag for CI/CD triggers.
dengoo_kit fix ios Quick Fix: Nukes Pods/, runs flutter clean, and pod install.
dengoo_kit shorebird ... Shorebird: Wrappers for Shorebird release/patch commands.

🛠️ Doctor & Troubleshooting

Ensure your environment is ready:

dengoo_kit doctor

Checks for:

  • Flutter & Dart SDKs
  • Keytool (Java) Availability
  • Path Configuration

🤝 Contributing

We welcome contributions! Please star the repo and submit PRs.

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

Built with ❤️ by the Tqniait Team.

Libraries