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.example.textguard, is a placeholder: 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 replace the placeholdergroup.com.example.textguardin 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).