rebrand_cli 1.0.5

A master orchestrator for Flutter rebranding. Automate app name, package name, bundle ID, and icon changes across Android and iOS with a single command.

🚀 Rebrand CLI

A powerful, zero-setup CLI tool for Flutter developers to fully rebrand an application in seconds. It automates the tedious parts of renaming package IDs, updating native labels, and generating icons/splash screens for both Android and iOS.

---

✨ Features

• Zero Manual Setup: Automatically adds worker dependencies (flutter_launcher_icons, flutter_native_splash, and change_app_package_name) to the target project.
• Deep Rename: Updates Package Name (Bundle ID) across Android and iOS source files.
• Native Label Update: Changes the "Home Screen" app name in AndroidManifest.xml and Info.plist.
• Asset Generation: One-click generation for Icons and Splash screens using a single config file.
• Clean & Safe: Uses temporary configurations to keep your pubspec.yaml clean.

---

🛠 Installation

Step 1: Install the Package

Activate the package globally using Dart:

dart pub global activate rebrand_cli

Step 2: Add to PATH (if rebrand command not found)

After installation, if you get "command not found: rebrand", you need to add the Dart pub cache bin directory to your system PATH.

macOS / Linux

Add the following line to your shell configuration file (~/.zshrc, ~/.bashrc, or ~/.bash_profile):

export PATH="$PATH:$HOME/.pub-cache/bin"

Then reload your shell:

source ~/.zshrc  # or source ~/.bashrc

Windows (PowerShell)

Add to your PowerShell profile or run:

$env:Path += ";$env:LOCALAPPDATA\Pub\Cache\bin"

To make it permanent, add to your system environment variables:

1. Press Win + X → Select "System"
2. Click "Advanced system settings" → "Environment Variables"
3. Under "User variables", find Path and click "Edit"
4. Add: %LOCALAPPDATA%\Pub\Cache\bin
5. Click "OK" and restart your terminal

Windows (Command Prompt)

set PATH=%PATH%;%LOCALAPPDATA%\Pub\Cache\bin

Verify Installation

rebrand

Alternative: Run directly without adding to PATH

If you don't want to modify your PATH, you can run the tool directly:

dart pub global run rebrand_cli:rebrand

You should see the Rebrand CLI banner if installed correctly.

---

🚀 Usage

Follow these simple steps to rebrand your Flutter app:

Step 1: Prepare Your Assets

Create an assets folder in your Flutter project root (if it doesn't exist) and add your app logo/icon image:

your_flutter_project/
├── assets/
│   └── logo.png          # Your app icon (recommended: 1024x1024 PNG)
├── lib/
├── android/
├── ios/
└── pubspec.yaml

Step 2: Create Configuration File

In the root directory of your Flutter project, create a file named rebrand_config.json:

{
    "app_name": "My New App",
    "package_name": "com.newcompany.app",
    "icon_path": "assets/logo.png",
    "splash_config": {
        "color": "#FFFFFF",
        "image": "assets/logo.png",
        "dark_color": "#111111"
    }
}

Configuration Options:

• app_name: The display name of your app (shown on home screen)
• package_name: Your new package/bundle identifier (e.g., com.yourcompany.appname)
• icon_path: Path to your app icon image
• splash_config:
  • color: Background color for splash screen (light mode)
  • image: Path to splash screen image
  • dark_color: Background color for splash screen (dark mode) - optional

Step 3: Run the Tool

Open your terminal, navigate to your Flutter project root, and run:

rebrand

Alternative: Run directly without adding to PATH

dart pub global run rebrand_cli:rebrand

That's it! The tool will automatically:

• ✅ Install required dependencies
• ✅ Update package names across Android and iOS
• ✅ Change app display names
• ✅ Generate app icons for all platforms
• ✅ Create splash screens (including Android 12 support)
• ✅ Clean and sync your project

---

📦 What It Modifies

• Android: Updates build.gradle, AndroidManifest.xml, and reorganizes package folder structures.
• iOS: Updates project.pbxproj, Info.plist, and Bundle Identifiers.
• Assets: Generates platform-specific app icons and native splash screens.

---

🤝 Contributing

Feel free to open issues or pull requests to improve the automation logic!

---

📄 License

This project is licensed under the MIT License.