🛠️ 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 ✅ GitLab MR checker scaffold for GetX conventions ✅ 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: <latest_version>

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

🛡️ GitLab PR Checker & Quality Dashboard #

Transform your Merge Requests into a professional quality gate. This tool generates a stakeholder-friendly dashboard that reviews code security, architecture, and best practices.

📊 What it does:

• Executive Scorecard: A high-level health score for PMs and Clients.
• Categorized Business Impact: Issues are grouped by Security, Architecture, and Quality.
• Direct Developer Feedback: Expandable technical details with file/line numbers for developers.
• Automated Emails: Beautiful, branded email reports sent to your team.

🚀 Quick Setup

# Basic setup
dart run smart_asset_generator prchecker label="Ashraf Rewamp"

# Update an existing checker
dart run smart_asset_generator prchecker label="Ashraf Rewamp" overwrite=true

🔒 Secure Email Management

For maximum security and ease of management, email recipients are controlled centrally via GitLab. Developers cannot change who receives these reports in the source code.

1. Go to GitLab Dashboard: Navigate to Settings > CI/CD > Variables.
2. Add Management Emails:
   • Key: PR_CHECKER_EMAILS
   • Value: manager@company.com, client@domain.com (comma-separated).

🔐 Required CI/CD Variables

To enable the full Dashboard and Email features, add these 4 variables in your GitLab Project Settings > CI/CD > Variables:

1. GITLAB_TOKEN: A Personal Access Token with api scope (Enable Masked).
2. PR_CHECKER_EMAILS: Comma-separated list of recipients (e.g., pm@co.com, client@co.com).
3. SMTP_USER: Your sender email (e.g., reports@yourcompany.com).
4. SMTP_PASSWORD: Your App Password (See below how to generate).

� How to get a Gmail App Password

If you are using Gmail, your regular password will not work. You must generate an "App Password":

1. Go to your Google Account Settings.
2. Navigate to Security.
3. Under "How you sign in to Google," ensure 2-Step Verification is ON.
4. Click on 2-Step Verification, then scroll to the bottom and click App Passwords.
5. Enter a name (e.g., "GitLab PR Checker") and click Create.
6. Copy the 16-character code and paste it as your SMTP_PASSWORD in GitLab.

Note: This setup is "set and forget." Once configured in GitLab, every new Merge Request will automatically generate a professional quality report.

🗂️ 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!