Rename and rebrand
name, ids, icon, colours, fonts.
Make the app yours before you publish. Everything is a small, listed edit; do all of them, because the store will refuse a bundle id that already belongs to someone else.
011. lib/brand.dart
Open app/lib/brand.dart. It holds:
| Constant | What it does |
|---|---|
appName, tagline | Name and tagline shown inside the app. |
accent | Main colour (default green 0xFF22C55E). The server's brand.accent may override it. |
above | Warm colour for "time above target" on the Night Strip. |
displayFont, bodyFont | Font family names (Sora and Geist). To change fonts, add the font files to app/assets/fonts/, register them in pubspec.yaml under fonts:, then change these two names. Keep each font's licence file. |
supportUrl, privacyUrl, termsUrl | Links shown in Settings. Empty hides the row. Fill them in before you publish. |
lifetimeIos, lifetimeAndroid, yearlyIos, yearlyAndroid | Store product ids. See Store products. |
apiBaseUrl | Read from --dart-define=API_BASE_URL=... at build time. Do not edit. |
methodChannel, eventChannel | Names shared with the Kotlin and Swift code. Only change them together with MainActivity.kt and ios/Runner/NativeBridge.swift. |
022. Android application id
- build.gradle.kts: in
app/android/app/build.gradle.ktschangeapplicationIdandnamespacefromcom.mikodes.chargelineto yours, for examplecom.yourcompany.yourapp. - Kotlin folder: rename the folders
app/android/app/src/main/kotlin/com/mikodes/chargelineto match the new id. - Package lines: change the
packageline at the top of each Kotlin file in that folder, and the channel names if you changed them inbrand.dart. - App label: in
app/android/app/src/main/AndroidManifest.xmlchangeandroid:label. - Check:
flutter build apk --releasemust still finish.
033. iOS bundle identifier and name
- Open
app/ios/Runner.xcworkspacein Xcode. - Select Runner, then Signing & Capabilities. Set your Team and your Bundle Identifier. (It is stored as
PRODUCT_BUNDLE_IDENTIFIERinios/Runner.xcodeproj/project.pbxproj.) - The home-screen name is
CFBundleDisplayNameinapp/ios/Runner/Info.plist.
044. App icon
Flutter runs natively on Windows: use PowerShell for the flutter commands and Android builds (iOS builds need a Mac). For the server, either install Node.js 22.12+ for Windows and use PowerShell (replace cp .env.example .env with Copy-Item .env.example .env; there is no openssl by default, so use WSL or any random 64-character hex string), or run the commands in WSL 2 (Ubuntu) or Docker. macOS and Linux users can ignore this note.
- Open
app/tool/make_icon.pyand change the colour lines at the top (BG,TRACK,ACCENT,ABOVE,WHITE). The icon has no text. - Run it (needs Pillow,
pip install pillow):cd app /usr/bin/python3 tool/make_icon.py dart run flutter_launcher_icons - Or skip the script and replace
app/assets/icon/icon.pngandicon_foreground.png(the Android adaptive foreground) with your own 1024 px PNGs, changeadaptive_icon_backgroundinpubspec.yamlif needed, then run the second command.
055. Habit cards and wording
The Learn tab shows short cards. Defaults are the list defaultCards in app/lib/src/core/config.dart; with a server they can be edited in the console under Habit cards. Each card needs an https source link and a review date. The five starter cards link to official Apple and Google help pages: read them and keep only what matches your app.
06Before you publish
- New name, application id, bundle id, icon.
- Your own Apple team and Android signing key (Release).
- Support, privacy and terms URLs filled in.
- Product ids set, or the paywall switched off.
- Search the project for the original name and ids to be sure none are left:
grep -ri chargeline app/lib app/android app/ios(and rename what remains).