fluttrify 1.0.1

A CLI tool to easily rename Flutter project package names for Android and iOS.

Fluttrify

A simple CLI tool to easily rename Flutter project package names for Android and iOS.

Overview

Fluttrify simplifies the process of changing package names in Flutter projects. When you need to rename your app's package identifier (e.g., from com.example.app to com.yourcompany.app), Fluttrify automates the tedious process of updating all the necessary files in both Android and iOS platforms.

Features

• ✅ Rename Android package names in:
  • AndroidManifest.xml files (main, debug, profile)
  • build.gradle
  • MainActivity.java/kt
• ✅ Rename iOS bundle identifiers in:
  • Info.plist
• ✅ Support for both platforms or individual platform updates
• ✅ Automatic file structure reorganization for Android
• 🚀 Fancy progress animation

Installation

From Source

# Clone the repository
git clone https://github.com/yourusername/fluttrify.git

# Navigate to the project directory
cd fluttrify

# Get dependencies
dart pub get

# Activate the package globally (optional)
dart pub global activate --source path .

Usage

Navigate to your Flutter project's root directory and run:

dart path/to/fluttrify.dart --new-package=com.yourcompany.appname

Options

-h, --help           Show usage information
-n, --new-package    New package name (e.g., com.example.app)
-p, --platform       Platform to rename: android, ios, or both (default: both)

Examples

# Rename package for both platforms
dart path/to/fluttrify.dart --new-package=com.yourcompany.appname

# Rename package for Android only
dart path/to/fluttrify.dart --new-package=com.yourcompany.appname --platform=android

# Rename package for iOS only
dart path/to/fluttrify.dart --new-package=com.yourcompany.appname --platform=ios

How It Works

Fluttrify performs the following operations:

1. For Android:

   • Updates the package attribute in all AndroidManifest.xml files
   • Updates applicationId in build.gradle
   • Updates package declaration in MainActivity.java/kt
   • Moves MainActivity to the correct directory structure based on the new package name

2. For iOS:

   • Updates CFBundleIdentifier in Info.plist

Requirements

• Dart SDK 3.6.0 or higher
• A Flutter project with standard directory structure

Limitations

• The tool assumes a standard Flutter project structure
• For iOS, if the CFBundleIdentifier uses variables (e.g., $(PRODUCT_BUNDLE_IDENTIFIER)), manual update is required
• The tool doesn't update references to the package name in your Dart code

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

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

Author

Built by aliarain