Rename Package & App Name
Safely change Flutter package/application identifiers, display name, Firebase config, and deep-link scheme.
The template's current native identifiers are com.soewidiputra.flonlate.mobile and the Dart package name is mobile.
Changing a package/bundle identifier creates a new store identity and invalidates links to existing Firebase, Google/Apple, RevenueCat, AdMob, and signing configuration. Plan the migration before changing a published app.
Automated native rename
From mobile-app/:
dart run change_app_package_name:main com.example.yourappReview the result rather than assuming every platform file/plugin was updated. Verify Android namespace/applicationId, Kotlin package paths, iOS bundle identifier, tests, and generated references.
Update display names separately:
- Android
android/app/src/main/AndroidManifest.xmlandroid:label. - iOS
ios/Runner/Info.plistCFBundleDisplayName/CFBundleName.
Dart package name (optional)
Changing name: mobile in pubspec.yaml is a source-wide rename. Replace every package:mobile/ import, then run:
flutter clean
flutter pub get
dart run build_runner build --delete-conflicting-outputsDo not edit generated .g.dart/.freezed.dart files by hand; regenerate them after the rename.
Deep-link scheme
The Account deep-link contract is:
flonlate://link?destination=reset-password&token=...&email=...To change it:
- Update
Endpoints.deepLinkSchemeinlib/constants/api_endpoints.dart. - Update Android
<data android:scheme="..." android:host="link" />inAndroidManifest.xml. - Update iOS
CFBundleURLSchemesinios/Runner/Info.plist. - Update backend-generated verification/reset links.
- Test malformed/unknown destinations and the
/linkhost contract.
Do not change the host to reset-password; link is the allowlisted entry point.
External services checklist
- Register the new Android/iOS identifiers in Firebase and rerun
flutterfire configure. - Update Google Sign-In client IDs and Apple Sign in with Apple capabilities/keys.
- Update RevenueCat app/store configuration and public build-time keys.
- Update AdMob app/ad-unit IDs.
- Reissue EAS/store signing credentials where required.
- Update privacy policy, store metadata, backend URLs, and notification config.
Verify
flutter analyze
flutter test
flutter build appbundle --releaseInstall the artifact on a physical device and test login, FCM, purchases, deep links, and account deletion before submission.
