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 (default Brierly, Forecast & Calibration Trainer). The server's brand name overrides the app name. |
accent, ink | Main colour (default warm orange 0xFFC4572A) and the ink blue of text, lines and the reliability diagram (0xFF14264A). The server's brand.accent may override the accent. |
displayFont, bodyFont, monoFont | Font family names (Instrument Serif, Instrument Sans, DM Mono). 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. |
attribution | The data credit shown wherever market questions appear when no server answer is available. Default Data: public market data, not affiliated. With a server, the server's line (see Attribution) replaces it. |
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. |
The built-in paywall headline and subline (Brierly Pro, Unlimited calls, full history and per-category calibration.) are defaults in app/lib/src/core/config.dart and in the server's server/src/admin/manifest.ts. With a server, change them in the console (App config: paywall); without one, edit config.dart.
022. Android application id
- build.gradle.kts: in
app/android/app/build.gradle.ktschangeapplicationIdandnamespacefromcom.mikodes.brierlyto yours, for examplecom.yourcompany.yourapp. - Kotlin folder: rename the folders
app/android/app/src/main/kotlin/com/mikodes/brierlyto 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(nowBrierly). - 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, nowcom.mikodes.brierly, and the test targetcom.mikodes.brierly.RunnerTests.) - 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. - Run it (needs Pillow,
pip install pillow):cd app python3 tool/make_icon.py dart run flutter_launcher_icons - Or skip the script and replace the PNGs under
app/assets/icon/(icon.pngandicon_foreground.png) with your own 1024 px images, then run the second command. The adaptive icon background colour is set inpubspec.yamlunderflutter_launcher_icons.
The icon script and launcher-icons run were not executed while writing this guide (unverified).
055. Name and colour from the server
With a server, the console's Brand page sets the app name, accent colour and support URL, and the Legal page the privacy and terms URLs, without a new build. See Console pages. The server's own product name inside the console (Brierly, in server/src/admin/manifest.ts) and the question-source credit line are separate edits.
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 brierly app/lib app/android app/ios server/src(and rename what remains; the console product name and the Docker names are among them).