Change Project Name

A powerful CLI tool to rename Flutter/Dart projects and automatically update all package references, and imports.

Features

• 🔄 Automatic Renaming: Updates project name in pubspec.yaml
• 📦 Import Updates: Finds and updates all package imports in Dart files
• ✅ Validation: Ensures new names follow Dart package naming conventions
• 🔍 Dry Run: Preview changes before applying them
• 🎯 Flexible Input: Multiple ways to specify the new project name
• 📱 Smart Detection: Automatically excludes build directories and tool files

Installation

Install globally using pub:

dart pub global activate change_project_name

Usage

Basic Usage

# Simple rename
change-project-name my_new_project

# Using --value flag
change-project-name --value my_new_project

# Interactive mode
change-project-name --interactive

Advanced Options

# Preview changes without applying them
change-project-name --dry-run my_new_project

# Verbose output
change-project-name --verbose my_new_project

# Show help
change-project-name --help

Programmatic Usage

You can also use the core logic in your own Dart scripts:

import 'dart:io';
import 'package:change_project_name/change_project_name.dart';

void main() async {
  final renamer = ProjectRenamer(
    projectDir: Directory.current,
    isDryRun: false, // Set to true to preview changes
    isVerbose: true,
  );

  try {
    await renamer.rename('old_name', 'new_name');
  } catch (e) {
    print('Error: $e');
  }
}

Command Line Options

Option	Short	Description
--value	-v	Specify the new project name
--interactive	-i	Run in interactive mode
--dry-run	-d	Preview changes without applying
--verbose		Show detailed output
--help	-h	Show help message

What Gets Updated

• ✅ pubspec.yaml - Project name
• ✅ All .dart files - Package import statements
• ✅ .dart_tool/package_config.json - Package configuration

Example

$ cd my_flutter_project
$ change-project-name awesome_app

📦 Current project name: old_project_name
🔄 Starting project rename from "old_project_name" to "awesome_app"...

🔄 Updating pubspec.yaml...
✅ Updated: pubspec.yaml

🔄 Updating Dart imports...
✅ Updated: ./lib/main.dart
✅ Updated: ./lib/src/app.dart
✅ Updated: ./.dart_tool/package_config.json

🎉 Done! Project successfully renamed to "awesome_app".
📌 2 Dart file(s) updated.

Package Name Validation

The tool validates that new project names follow Dart package naming conventions:

• Must be lowercase
• Can contain underscores and numbers
• Must start with a letter or underscore
• Cannot start with numbers

✅ Valid: my_app, myapp, my_app_v2
❌ Invalid: MyApp, my-app, 2myapp

Requirements

• Dart SDK 2.17.0 or higher
• Must be run from a Flutter/Dart project root (directory containing pubspec.yaml)

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.