Brierly 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 (default Brierly, Forecast & Calibration Trainer). The server's brand name overrides the app name.
accent, inkMain 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, monoFontFont 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.
attributionThe 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, 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.

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

  1. build.gradle.kts: in app/android/app/build.gradle.kts change applicationId and namespace from com.mikodes.brierly to yours, for example com.yourcompany.yourapp.
  2. Kotlin folder: rename the folders app/android/app/src/main/kotlin/com/mikodes/brierly 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 (now Brierly).
  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, now com.mikodes.brierly, and the test target com.mikodes.brierly.RunnerTests.)
  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.
  2. Run it (needs Pillow, pip install pillow):
    cd app
    python3 tool/make_icon.py
    dart run flutter_launcher_icons
  3. Or skip the script and replace the PNGs under app/assets/icon/ (icon.png and icon_foreground.png) with your own 1024 px images, then run the second command. The adaptive icon background colour is set in pubspec.yaml under flutter_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).