Chargeline docs
v1.0.0
Get help
● Start

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.

brand.dartpackage idbundle idicon

011. lib/brand.dart

Open app/lib/brand.dart. It holds:

ConstantWhat it does
appName, taglineName and tagline shown inside the app.
accentMain colour (default green 0xFF22C55E). The server's brand.accent may override it.
aboveWarm colour for "time above target" on the Night Strip.
displayFont, bodyFontFont 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, termsUrlLinks shown in Settings. Empty hides the row. Fill them in before you publish.
lifetimeIos, lifetimeAndroid, yearlyIos, yearlyAndroidStore product ids. See Store products.
apiBaseUrlRead from --dart-define=API_BASE_URL=... at build time. Do not edit.
methodChannel, eventChannelNames shared with the Kotlin and Swift code. Only change them together with MainActivity.kt and ios/Runner/NativeBridge.swift.

022. Android application id

  1. build.gradle.kts: in app/android/app/build.gradle.kts change applicationId and namespace from com.mikodes.chargeline to yours, for example com.yourcompany.yourapp.
  2. Kotlin folder: rename the folders app/android/app/src/main/kotlin/com/mikodes/chargeline to match the new id.
  3. Package lines: change the package line at the top of each Kotlin file in that folder, and the channel names if you changed them in brand.dart.
  4. App label: in app/android/app/src/main/AndroidManifest.xml change android:label.
  5. Check: flutter build apk --release must still finish.

033. iOS bundle identifier and name

  1. Open app/ios/Runner.xcworkspace in Xcode.
  2. Select Runner, then Signing & Capabilities. Set your Team and your Bundle Identifier. (It is stored as PRODUCT_BUNDLE_IDENTIFIER in ios/Runner.xcodeproj/project.pbxproj.)
  3. The home-screen name is CFBundleDisplayName in app/ios/Runner/Info.plist.

044. App icon

Windows users

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.

  1. Open app/tool/make_icon.py and change the colour lines at the top (BG, TRACK, ACCENT, ABOVE, WHITE). The icon has no text.
  2. Run it (needs Pillow, pip install pillow):
    cd app
    /usr/bin/python3 tool/make_icon.py
    dart run flutter_launcher_icons
  3. Or skip the script and replace app/assets/icon/icon.png and icon_foreground.png (the Android adaptive foreground) with your own 1024 px PNGs, change adaptive_icon_background in pubspec.yaml if 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).