Rename and rebrand
name, ids, App Group, 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. |
accent | Main colour (default deep teal 0xFF0F766E). The server's brand.accent may override it. |
flag | Second colour, used for the flagged words in a message (amber). |
displayFont, bodyFont | Font family names (Newsreader, Atkinson Hyperlegible Next). 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. 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. |
appGroup | The App Group shared by the app and the iOS filter extension. The value in the source, group.com.mikodes.textguard, belongs to this item: replace it with your own (see step 3). |
methodChannel | Name shared with MainActivity.kt (the Android share-in) and the Swift code. Change all together. |
022. Android application id
- build.gradle.kts: in
app/android/app/build.gradle.ktschangeapplicationIdandnamespacefromcom.mikodes.textguardto yours, for examplecom.yourcompany.yourapp. - Kotlin folder: rename the folders
app/android/app/src/main/kotlin/com/mikodes/textguardto match the new id. - Package line: change the
packageline at the top ofMainActivity.kt, and the channel name if you changed it inbrand.dart. - App label: in
app/android/app/src/main/AndroidManifest.xmlchangeandroid:label. - Check:
flutter build apk --releasemust still finish.
033. iOS bundle identifiers and App Group
The project has two iOS targets: Runner (the app, com.mikodes.textguard) and TextguardFilter (the extension, com.mikodes.textguard.filter). The extension's id must start with the app's id. No Apple team id ships in the source.
- Open
app/ios/Runner.xcworkspacein Xcode. - For Runner and for TextguardFilter, open Signing & Capabilities and set your Team and a Bundle Identifier you own (for example
com.yourcompany.yourappandcom.yourcompany.yourapp.filter). - App Group. In your Apple developer account create an App Group such as
group.com.yourcompany.yourapp, add it under Capabilities, App Groups for both targets, then replacegroup.com.mikodes.textguard(the placeholder that ships) in all five places:ios/Runner/Runner.entitlements,ios/TextguardFilter/TextguardFilter.entitlements,ios/Runner/NativeBridge.swift,ios/TextguardFilter/MessageFilterExtension.swiftandlib/brand.dart. Without a matching group the extension cannot read the rule pack the app hands over and falls back to the rules bundled in the extension. - 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. The icon has no text. - Run it (needs Pillow,
pip install pillow):cd app /usr/bin/python3 tool/make_icon.py dart run flutter_launcher_icons - Or skip the script and replace the icon PNGs under
app/assets/icon/with your own 1024 px images, then run the second command.
055. Rules, report contacts and lessons
The starter content lives in server/seed/*.json (46 rules, 9 report offices, 6 lessons). To change what ships inside the app, edit those files, then copy them to app/assets/defaults/ (tool/sync_defaults.sh) and the rules to app/ios/TextguardFilter/default-rules.json. With a server you manage the same content in the console (Rule packs). Every report office and lesson needs an https source link and a review date. Add only facts you can point to, and have someone who knows each country read the lessons.
06Before you publish
- New name, application id, bundle id, icon.
- Your own Apple team, App Group (placeholder replaced in five places) 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 textguard app/lib app/android app/ios(and rename what remains).