Search packages, repositories and app categories

Package detailsv1.6.6

rename_app

The flutter package which changes app name for all platforms with sound null safety!

AndroidiOSmacOSWindowsLinux
30-day downloads
22K
Likes
361
Pub points
140

Install package

flutter pub add rename_app

Package Overview

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.

Stand With Palestine

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 😇

Developer : Syed Waleed Shah ( LinkedIn Github StackOverflow )

Please Contribute : Github Repository

Honourable Contributors:

  1. Finn Drünert ( Github )
  2. nhan7777 ( Github )
  3. Harsh Yadav ( Github )

Features 🔥

✅ Rename Android Project

✅ Rename IOS Project

✅ Rename WEB Project

✅ Rename Windows Project

✅ Rename Linux Project

What rename_app does

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"
Separate name for each platform
dart run rename_app:main android="Android Name" ios="IOS Name" web="Web Name" mac="Mac Name" windows="Windows Name" linux="Linux Name"

More Flexibilities 😎

REQUIREMENT COMMAND
From pubspec Add config_name.name, then dart run rename_app:main (no arguments)
All Same dart run rename_app:main all="App Name"
Only Android dart run rename_app:main android="Android App"
Only IOS dart run rename_app:main ios="IOS App"
Only WEB dart run rename_app:main web="Web App"
ONLY Windows dart run rename_app:main windows="Windows App"
ONLY Linux dart run rename_app:main linux="Linux App"
With Others dart run rename_app:main android="Android App" ios="IOS App" others="Others App Name"

Categories

Dependencies

Dependency list 2 items

Source repository

Projects using this package