🛠️ Smart Asset Generator #

A powerful and flexible Dart/Flutter CLI tool to auto-generate asset reference classes, barrel files, and GetX module scaffolding — making asset management and project structure consistent, clean, and fast.

✨ Features #

✅ Automatically scans folders and generates asset reference classes (AppImages, etc.) ✅ Converts file names to camelCase constants ✅ Supports nested folders and all file types ✅ Barrel file generator to export Dart files from any directory ✅ Modular code generator for GetX (controller, binding, view) ✅ Project cloning with custom Android/iOS package names and optional path ✅ CLI-ready with clean syntax ✅ Fully customizable output structure ✅ Works in Flutter and pure Dart projects ✅ Build Android APK / iOS IPA and upload to Loadly (Diawi alternative) ✅ One command to build both APK and IPA with install links printed

📦 Use Cases #

• Generate AppImages class to avoid hardcoded asset strings
• Create exports.dart barrel file to group exports cleanly
• Scaffold complete module (binding/controller/view) with a single command
• Clone a Flutter project with new app name and package IDs
• Keep your imports scalable and clean in large projects

🚀 Installation #

In your Flutter/Dart project’s pubspec.yaml:

dev_dependencies:
  smart_asset_generator:
    path: ../smart_asset_generator  # adjust path as needed

Then run:

flutter pub get

🏃 CLI Usage #

Run using:

dart run smart_asset_generator <command> [arguments]

🔹 Commands Overview #

🖼️ Generate Asset Class #

dart run smart_asset_generator asset <asset_path> [class_name]

✅ Example

dart run smart_asset_generator asset assets/images AppImages

Output:

lib/generated/app_images.dart

📦 Generate Barrel File #

dart run smart_asset_generator barrel <directory_path> [output_file_name]

✅ Example

dart run smart_asset_generator barrel lib/widgets widget_exports

Output:

lib/widgets/widget_exports.dart

🧱 Generate Module (GetX structure) #

dart run smart_asset_generator module name=<module_name> location=<path> [export=<barrel_file_path>]

✅ Example

dart run smart_asset_generator module name=home location=lib/modules

Creates:

lib/modules/home/
├── bindings/home_binding.dart
├── controller/home_controller.dart
└── view/home_page.dart

Also appends exports to:

lib/modules/exports.dart

You can override export file:

dart run smart_asset_generator module name=login location=lib/ui export=lib/ui/index.dart

🔁 Clone Existing Project #

dart run smart_asset_generator clone name=<new_project_name> android=<android_package> ios=<ios_package> [path=<directory_path>]

✅ Example

dart run smart_asset_generator clone name=new_app android=com.new.android ios=com.new.ios path=/Users/you/FlutterProjects

Performs:

• Duplicates current project folder to the specified path (or the parent folder if path is not provided)
• Updates:
  • pubspec.yaml project name
  • Android: applicationId in build.gradle, AndroidManifest.xml, .iml files
  • iOS: CFBundleIdentifier in Info.plist
  • Renames root .iml and Android module .iml files
  • Replaces package names and project references in all source files
• Ensures the cloned project is ready to open and run independently

☁️ Build APK and Upload to Loadly #

dart run smart_asset_generator apk [release|debug] apiKey=<YOUR_API_KEY> [buildInstallType=1|2|3] [buildPassword=<pwd>] [desc=<notes>]

✅ Example

dart run smart_asset_generator apk release apiKey=YOUR_KEY buildInstallType=1 desc="Initial release"

On success, the tool prints the install page URL, shortcut URL (if any), and build key returned by Loadly.

🍎 Build IPA and Upload to Loadly (macOS only) #

dart run smart_asset_generator ipa [apiKey=<YOUR_API_KEY>] [buildInstallType=1|2|3] [buildPassword=<pwd>] [desc=<notes>]

✅ Example

dart run smart_asset_generator ipa apiKey=YOUR_KEY buildInstallType=1 desc="iOS test build"

Note: Requires macOS with iOS signing configured in Xcode.

🔀 Build Both: APK + IPA (with links) #

dart run smart_asset_generator apps [release|debug] [apiKey=<YOUR_API_KEY>] [buildInstallType=1|2|3] [buildPassword=<pwd>] [desc=<notes>]

✅ Example

dart run smart_asset_generator apps release apiKey=YOUR_KEY desc="Weekly QA build"

The command prints separate APK and IPA install links from Loadly.

🧰 One-time Init (optional) #

Create a project config file to store your Loadly API key and see handy example commands:

dart run smart_asset_generator init

This creates smart_asset_generator.yaml. Add your API key under:

loadlyApiKey: "YOUR_KEY"

You can still pass apiKey=YOUR_KEY inline to any command if you prefer.

You can visit this website to create apiKey https://loadly.io/doc/view/api

🗂️ Output Summary #

📄 License #

MIT License
© 2025 Divyarajsinh Jadeja

🙌 Contributions #

Pull requests, issues, and suggestions are welcome!
If this tool saves you time, please ⭐ star the repo and share it with your team!