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.
011. lib/brand.dart
Open app/lib/brand.dart. It holds:
| Constant | What it does |
|---|---|
appName, tagline | Name and tagline shown inside the app (shipped: Callbook, Receipts for Market Calls). |
accent | Main colour (shipped: ink stamp 0xFFC2410C). The server's brand.accent may override it. |
displayFont, bodyFont, monoFont | Font 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, termsUrl | Links shown in Settings. Empty hides the row. They are empty as shipped: fill them in before you publish. |
lifetimeIos, lifetimeAndroid, yearlyIos, yearlyAndroid | Store product ids. See Store products. Empty as shipped. |
apiBaseUrl | Read from --dart-define=API_BASE_URL=... at build time. Do not edit. |
022. Android application id
- build.gradle.kts: in
app/android/app/build.gradle.ktschangeapplicationIdandnamespacefromcom.mikodes.callbookto yours, for examplecom.yourcompany.yourapp. - Kotlin folder: rename the folder
app/android/app/src/main/kotlin/com/mikodes/callbookto match the new id. - Package line: change the
packageline at the top ofMainActivity.kt. - App label: in
app/android/app/src/main/AndroidManifest.xmlchangeandroid:label(shipped: Callbook). - 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. (Stored as
PRODUCT_BUNDLE_IDENTIFIERinios/Runner.xcodeproj/project.pbxproj; shipped valuecom.mikodes.callbook.) - 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. npm run keygen is plain Node and works the same in PowerShell. macOS and Linux users can ignore this note.
- Open
app/tool/make_icon.pyand change the colour lines at the top (INK,PAPER,LINE,ACCENT). The icon has no text. - Run it (needs Pillow,
pip install pillow):
On Windows usecd app /usr/bin/python3 tool/make_icon.py dart run flutter_launcher_iconspython tool/make_icon.py. - Or skip the script and replace
app/assets/icon/icon.pngandicon_foreground.pngwith 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 textcallbook/1in the hash format is part of the chain format, see Receipts, so change it only before the first receipt is ever sealed).