Clonify

About

A powerful command-line tool for managing multiple Flutter project clones with different configurations, branding, and Firebase projects. Perfect for white-label applications or managing multiple client-specific versions of the same Flutter app.

Features

🎨 Manage multiple app variants from a single codebase
🔥 Optional Firebase integration per clone
📱 Auto-generate launcher icons and splash screens
📦 Rename packages and app names per clone
🏗️ Build multiple platforms (Android APK/AAB, iOS IPA)
🚀 Optional Fastlane integration for app store uploads
💾 Configuration persistence for easy switching between clones
✨ Modern TUI (Text User Interface) with interactive prompts and progress indicators

Installation

Prerequisites

Dart SDK (^3.8.1)
Flutter SDK (for building apps)
Firebase CLI (optional, for Firebase features)
Fastlane (optional, for upload features)

Important: Required Dev Dependencies

Clonify relies on the following packages to automate asset generation. Add these to your Flutter project's dev_dependencies for full functionality:

dev_dependencies:
  flutter_launcher_icons: ^0.13.1  # Automated launcher icon generation
  flutter_native_splash: ^2.3.1     # Splash screen creation
  intl_utils: ^2.8.7                # Internationalization (optional)

Why these are needed:

Clonify calls these tools as external commands to generate icons and splash screens
The tool will check for their presence and warn you if they're missing
You don't need to import them in your code - Clonify uses them automatically

Note: Package renaming functionality is now built directly into Clonify - no external package required!

Install Globally

Install clonify globally to use it from anywhere:

# From pub.dev (once published)
dart pub global activate clonify

# Or install from source
git clone https://github.com/DevMohammadSalameh/clonify.git
cd clonify
dart pub global activate --source path .

Make sure your PATH includes the Dart global bin directory:

macOS/Linux: ~/.pub-cache/bin
Windows: %LOCALAPPDATA%\Pub\Cache\bin

Verify installation:

clonify --version  # or clonify -v
clonify --help

User Interface

Clonify features a modern Text User Interface (TUI) that enhances your development experience with:

Interactive Prompts

🎯 Arrow-key navigation for selecting options (type selection, multiple choices)
✅ Smart validation with immediate feedback for inputs (colors, URLs, package names, versions)
🎨 Color-coded messages for success (green), errors (red), warnings (yellow), and info (blue)
📋 Configuration summaries showing all settings before applying
🔄 Confirmation prompts with sensible defaults for quick workflows

Progress Indicators

📦 Package renaming with real-time progress feedback
🔥 Firebase configuration progress tracking
🎨 Asset replacement progress updates
🚀 Launcher icon generation with completion status
💦 Splash screen creation progress
🌍 Internationalization file generation progress
🛠️ Build operations with unified progress tracking for APK/AAB/IPA

Enhanced Commands

init - Interactive wizard with emoji indicators and type selection
create - Guided clone creation with validation and configuration summary
list - Colored tables with active client highlighting and emoji column headers
configure - Progress indicators for all long-running operations
build - Unified build progress with elapsed time tracking

Accessibility

🔌 TTY detection - Automatically detects terminal capabilities
🎛️ Fallback mode - Works in CI/CD and non-interactive environments
🚫 --no-tui flag - Disable TUI features for basic text mode
🎨 NO_COLOR support - Respects environment variable for color-blind accessibility
⏭️ --skipAll flag - Skip all interactive prompts for automation

Examples

# Use TUI features (default)
clonify create

# Disable TUI for CI/CD environments
clonify create --no-tui

# Skip all prompts for automation
clonify configure --skipAll

Quick Start

1. Initialize Clonify

Set up your project with global configuration:

clonify init

This will prompt you for:

Firebase configuration (optional)
Fastlane configuration (optional)
Company name
Default app color
Assets selection (launcher icon, splash screen, logo)
Custom configuration fields (optional) - define custom fields that will be required for each clone

Creates: ./clonify/clonify_settings.yaml

2. Create Your First Clone

Create a new client-specific configuration:

clonify create

This will prompt you for:

Client ID (unique identifier)
Base URL for API
Primary color
Package name (e.g., com.company.clienta)
App name
Version
Firebase project ID (if Firebase enabled)
Custom field values (if custom fields were defined during init)

Creates: ./clonify/clones/{clientId}/config.json and assets directory

3. Configure Your Flutter Project

Apply a clone's configuration to your Flutter project:

clonify configure --clientId your_client_id

# Or use the last configured client
clonify configure

This will:

Rename app and package
Configure Firebase (if enabled)
Update launcher icons and splash screens
Sync versions
Generate compile-time configuration class

Generates: lib/generated/clone_configs.dart this class can be used in your project for accessing clone specific attributes.

4. Build Your App

Build platform-specific artifacts:

# Build Android AAB and iOS IPA (default)
clonify build --clientId your_client_id

# Build specific platforms
clonify build --clientId your_client_id --buildApk --no-buildAab

# Use last client ID
clonify build

5. List All Clones

View all configured clones:

clonify list

Commands

Global Options

Available for all commands:

--no-tui - Disable TUI (Text User Interface) features and use basic text mode
--help - Display help information for any command

`clonify init`

Initialize Clonify environment with global settings.

Aliases: i, initialize

`clonify create`

Create a new Flutter project clone configuration.

Aliases: create-clone

`clonify configure [options]`

Configure the Flutter project for a specific client.

Aliases: con, config, c

Options:

--clientId <id> - Client ID to configure (or use last)
--skipAll - Skip all user prompts
--autoUpdate - Automatically increment version
--isDebug - Run in debug mode
--skipFirebaseConfigure - Skip Firebase configuration
--skipPubUpdate - Skip pubspec.yaml updates
--skipVersionUpdate - Skip version updates

`clonify build [options]`

Build the Flutter project clone.

Aliases: b

Options:

--clientId <id> - Client ID to build (or use last)
--skipAll - Skip all user prompts
--buildAab - Build Android App Bundle (default: true)
--buildApk - Build Android APK (default: false)
--buildIpa - Build iOS IPA (default: true)
--skipBuildCheck - Skip pre-build checks

`clonify upload [options]`

Upload builds to app stores via Fastlane.

Aliases: up, u

Options:

--clientId <id> - Client ID to upload
--skipAll - Skip all prompts
--skipAndroidUploadCheck - Skip Android upload verification
--skipIOSUploadCheck - Skip iOS upload verification

`clonify list`

List all configured clones.

Aliases: l, list-clones, ls

`clonify which`

Display the current clone configuration.

Aliases: w, current, who

`clonify clean [options]`

Clean up a partial or broken clone.

Aliases: clear

Options:

--clientId <id> - Client ID to clean (required)

Configuration Files

Global Settings: `./clonify/clonify_settings.yaml`

firebase:
  enabled: true
  settings_file: "path/to/firebase.json"

fastlane:
  enabled: false
  settings_file: ""

company_name: "Your Company"
default_color: "#FFFFFF"

clone_assets:
  - icon.png
  - splash.png
  - logo.png

launcher_icon_asset: "icon.png"
splash_screen_asset: "splash.png"

# Optional: Custom configuration fields
custom_fields:
  - name: "socketUrl"
    type: "string"
  - name: "maxRetries"
    type: "int"
  - name: "enableDebug"
    type: "bool"

Per-Clone Config: `./clonify/clones/{clientId}/config.json`

{
  "clientId": "client_a",
  "packageName": "com.company.clienta",
  "appName": "Client A App",
  "baseUrl": "https://api.client-a.com",
  "primaryColor": "0xFF6200EE",
  "firebaseProjectId": "firebase-client-a",
  "version": "1.0.0+1",
  "socketUrl": "wss://socket.client-a.com",
  "maxRetries": "5",
  "enableDebug": "false",
  "colors": [
    {
      "name": "primaryBlue",
      "color": "6200EE"
    }
  ],
  "linearGradients": [
    {
      "name": "primaryGradient",
      "colors": ["6200EE", "03DAC6"],
      "begin": "topLeft",
      "end": "bottomRight",
      "transform": "0"
    }
  ]
}

Generated Config: `lib/generated/clone_configs.dart`

abstract class CloneConfigs {
  static const String clientId = "client_a";
  static const String baseUrl = "https://api.client-a.com";
  static const String version = "1.0.0+1";
  static const String primaryColor = "0xFF6200EE";
  static const String socketUrl = "wss://socket.client-a.com";
  static const int maxRetries = 5;
  static const bool enableDebug = false;
  static const primaryBlue = Color(0xFF6200EE);
  static const primaryGradient = LinearGradient(...);
}

Use in your Flutter app:

import 'package:your_app/generated/clone_configs.dart';

// Access configuration
final baseUrl = CloneConfigs.baseUrl;
final clientId = CloneConfigs.clientId;
final primaryColor = CloneConfigs.primaryBlue;

// Access custom fields
final socketUrl = CloneConfigs.socketUrl;
final maxRetries = CloneConfigs.maxRetries;
final isDebugEnabled = CloneConfigs.enableDebug;

Workflow Example

Managing Multiple Clients

# Initial setup (one time)
clonify init

# Create client A
clonify create
# Enter: client_a, com.company.clienta, etc.

# Create client B
clonify create
# Enter: client_b, com.company.clientb, etc.

# Work on client A
clonify configure --clientId client_a
clonify build --clientId client_a

# Switch to client B
clonify configure --clientId client_b
clonify build --clientId client_b

# List all clients
clonify list

Optional Features

Firebase Integration

Firebase is optional. To use Firebase:

Enable during clonify init
Provide path to firebase.json
During clone creation, provide Firebase project ID
Clonify will create Firebase project and configure Flutterfire

To skip Firebase:

Set firebase.enabled: false in settings
Use --skipFirebaseConfigure flag

Fastlane Integration

Fastlane is optional. To use Fastlane:

Enable during clonify init
Provide path to Fastlane settings
Use clonify upload to deploy to stores

Development

Run Tests

dart test

Run Linter

dart analyze

Format Code

dart format .

Build Executable

dart compile exe bin/clonify.dart

Requirements

Dart SDK ^3.8.1
Flutter SDK (for building apps)
Firebase CLI (optional, if using Firebase features)
Fastlane (optional, if using upload features)
Xcode (for iOS builds on macOS)
Android SDK (for Android builds)

Contributing

Contributions are welcome! Please read the contributing guidelines before submitting PRs.

Changelog

For all notable changes to this project, refer to the CHANGELOG.

Support

For any issues or suggestions, please open an issue. Your feedback is highly appreciated.

Version

This is a pre-release version. The API may change in future releases. Feedback and bug reports are welcome!

License

GPL v3 (GNU General Public License v3.0) - see LICENSE file for details.

What this means:

✅ Free to use for any purpose (including commercial projects)
✅ Free to modify and study the code
✅ Can sell applications built WITH this tool
❌ Cannot sell this tool itself as closed-source software
⚠️ If you distribute modified versions, you MUST share the source code under GPL v3

Full license: https://www.gnu.org/licenses/gpl-3.0.txt

Author

Mohammad Salameh

GitHub: @DevMohammadSalameh
Repository: https://github.com/DevMohammadSalameh/clonify
Issues: https://github.com/DevMohammadSalameh/clonify/issues

Acknowledgments

Built with ❤️ for the Flutter community, inspired by the need for efficient white-label app management.

Special Thanks to Open Source Contributors

Clonify leverages these excellent community packages:

Core TUI Libraries:

mason_logger - Interactive CLI prompts and progress indicators
chalkdart - Terminal string styling and colors

Asset Generation Tools (Called by Clonify):

flutter_launcher_icons - Automated launcher icon generation
flutter_native_splash - Splash screen creation

Internalized Tools:

package_rename_plus - Package renaming functionality (now built directly into Clonify v0.4.3+)

Architecture Inspiration:

Inspired by the architecture of the rename package for Flutter project management

A huge thank you to all the maintainers and contributors of these projects! 🙏

Name		Name	Last commit message	Last commit date
Latest commit History 73 Commits
.vscode		.vscode
bin		bin
doc		doc
example		example
lib		lib
test		test
.DS_Store		.DS_Store
.gitignore		.gitignore
.pubignore		.pubignore
CHANGELOG.md		CHANGELOG.md
CLAUDE.md		CLAUDE.md
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
README.md		README.md
analysis_options.yaml		analysis_options.yaml
pubspec.lock		pubspec.lock
pubspec.yaml		pubspec.yaml

Folders and files

Latest commit

History

Repository files navigation

Clonify

About

Features

Installation

Prerequisites

Important: Required Dev Dependencies

Install Globally

User Interface

Interactive Prompts

Progress Indicators

Enhanced Commands

Accessibility

Examples

Quick Start

1. Initialize Clonify

2. Create Your First Clone

3. Configure Your Flutter Project

4. Build Your App

5. List All Clones

Commands

Global Options

clonify init

clonify create

clonify configure [options]

clonify build [options]

clonify upload [options]

clonify list

clonify which

clonify clean [options]

Configuration Files

Global Settings: ./clonify/clonify_settings.yaml

Per-Clone Config: ./clonify/clones/{clientId}/config.json

Generated Config: lib/generated/clone_configs.dart

Workflow Example

Managing Multiple Clients

Optional Features

Firebase Integration

Fastlane Integration

Development

Run Tests

Run Linter

Format Code

Build Executable

Requirements

Contributing

Changelog

Support

Version

License

Author

Acknowledgments

Special Thanks to Open Source Contributors

About

Topics

Resources

Code of conduct

Contributing

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages

`clonify init`

`clonify create`

`clonify configure [options]`

`clonify build [options]`

`clonify upload [options]`

`clonify list`

`clonify which`

`clonify clean [options]`

Global Settings: `./clonify/clonify_settings.yaml`

Per-Clone Config: `./clonify/clones/{clientId}/config.json`

Generated Config: `lib/generated/clone_configs.dart`