Package selection guidance compiled from public package information, community data, and project usage.
A Flutter package that simplifies changing the app name across all platforms—Android, iOS, macOS, Windows, and Linux—with full support for sound null safety. It automates the process of updating platform-specific configuration files, ensuring consistency and reducing manual errors. Ideal for developers who need to quickly rebrand or customize their app's display name without navigating complex native project structures.
Use cases
Rebranding an existing app
Customizing app name per build variant
Streamlining multi-platform app naming
Automating app name updates in CI/CD pipelines
Updating app name without editing native files
Key features
Cross-platform compatibility
Sound null safety support
Automated configuration updates
Simple CLI integration
Preserves existing app structure
Suitable for
Flutter developers managing multiple app variants
Teams requiring consistent app naming
Projects with frequent branding changes
Developers using automated build workflows
Considerations
Requires manual verification after update
May conflict with custom build configurations
Not suitable for apps with highly customized native setup
Limited to app name changes only
Does not handle icon renaming
Original README
Original README snapshot from the linked source repository. Visit the repository for the latest content.
Rename App
The only flutter package which changes app name for all platforms with sound null safety!
If you want to autmatically change your flutter app name with a single command then you are at the right pacakge. This package gives you too many flexibilities through too many variants of its commands. Read the details below to know in more details
✊ Dont forget to star the github repo if you found this package useful 😇
rename_app is a command-line helper you run against a Flutter app project. From the project root (the folder where your app’s pubspec.yaml lives), it edits the platform files that expose the launcher / UI display name. For example: Android (AndroidManifest.xml label), iOS (Info.plist and variants when present), Web (manifest.json), Windows runner sources, and Linux application metadata.
It does not automatically change strings inside your Dart code (such as MaterialApp(title: …)): that stays up to you. For each platform, if the expected config file is missing or you pass an empty name for that platform, that platform is skipped and a short message may be logged.
Arguments like android="..." only update Android; omitting others leaves those platforms untouched. all="..." and config_name.name apply the same name across Android, iOS, Web, Windows, and Linux in one shot.
macOS renaming is currently not wired in the tool (mac CLI is listed for compatibility).
How To Rename ? 🛠
1) ADD THE PACKAGE TO YOUR pubspec.yaml
You only need the package to run dart run rename_app:main, so dev_dependency is typical for an app:
dart pub add rename_app --dev
Alternatively, add rename_app under dependencies: if your workflow prefers that.
2) PROVIDE THE APP NAME
Run commands from your Flutter project directory (pubspec.yaml must exist there). Names are arbitrary display strings — use quoting on the CLI when they contain spaces.
You can supply the app name in two complementary ways:
A — From pubspec.yaml (no CLI arguments)
Add a config_name block at the top level of pubspec.yaml (alongside name:, description:, etc.):
config_name:name:"My App"
name must be a string. If config_name.name is present, running with zero arguments:
dart run rename_app:main
is equivalent to dart run rename_app:main all="My App" — same name for Android, iOS, Web, Windows, and Linux.
pubspec.yaml must parse as YAML. If the block is missing, name is missing/wrong type, or reading the file fails, the tool prints the help message and exits (same as older versions without config_name).
CLI always wins: as soon as you pass any argument (for example all="..." or android="..."), config_name is not used for that invocation.
B — From the CLI (explicit arguments)
Same name for all supported platforms:
Same name for all apps
dart run rename_app:main all="My App Name"
Separate name for specified platform(s) and same for all others
dart run rename_app:main android="Android Name" ios="IOS Name" others="Others Name"