Callbook 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 a store refuses a bundle id that 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 (shipped: Callbook, Receipts for Market Calls).
accentMain colour (shipped: ink stamp 0xFFC2410C). The server's brand.accent may override it.
displayFont, bodyFont, monoFontFont family names (BarlowCondensed, FiraSans, JetBrainsMono). To change fonts, add the font files to app/assets/fonts/, register them in pubspec.yaml under fonts:, then change these names. Keep each font's licence file.
supportUrl, privacyUrl, termsUrlLinks shown in Settings. Empty hides the row. They are empty as shipped: fill them in before you publish.
lifetimeIos, lifetimeAndroid, yearlyIos, yearlyAndroidStore product ids. See Store products. Empty as shipped.
apiBaseUrlRead from --dart-define=API_BASE_URL=... at build time. Do not edit.

022. Android application id

  1. build.gradle.kts: in app/android/app/build.gradle.kts change applicationId and namespace from com.mikodes.callbook to yours, for example com.yourcompany.yourapp.
  2. Kotlin folder: rename the folder app/android/app/src/main/kotlin/com/mikodes/callbook to match the new id.
  3. Package line: change the package line at the top of MainActivity.kt.
  4. App label: in app/android/app/src/main/AndroidManifest.xml change android:label (shipped: Callbook).
  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. (Stored as PRODUCT_BUNDLE_IDENTIFIER in ios/Runner.xcodeproj/project.pbxproj; shipped value com.mikodes.callbook.)
  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. npm run keygen is plain Node and works the same in PowerShell. macOS and Linux users can ignore this note.

  1. Open app/tool/make_icon.py and change the colour lines at the top (INK, PAPER, LINE, ACCENT). 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
    On Windows use python tool/make_icon.py.
  3. Or skip the script and replace app/assets/icon/icon.png and icon_foreground.png with your own 1024 px images, then run the second command.

055. Brand in the console

With a server you can also change the app name, accent colour and support URL without a new build: Brand. Server values override brand.dart.

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 callbook app/lib app/android app/ios (and rename what remains; the receipt text callbook/1 in the hash format is part of the chain format, see Receipts, so change it only before the first receipt is ever sealed).