Rebranding
your name, your ID, your icon.
What you can change in Settings without rebuilding, and what is compiled into the app: the app name, the bundle ID, the icon and the colours. Do these before your first store upload; a bundle ID cannot be changed after that.
01Without rebuilding
In Settings → Branding and support: the Brand name in the app header, plus support email, website, documentation and terms links. In Vocabulary: the words (members, licences, points…). To give every install the same values, use a published config.
02App name
The name under the icon and in the browser tab is compiled in. Replace MIKODES Token Forge in:
| File | What |
|---|---|
lib/app.dart | title: of the app (task switcher, browser tab) |
lib/core/config/forge_config.dart | Default brandName (two places: the constructor and fromJson) |
lib/features/settings/settings_screen.dart | The Product line in Effective configuration |
web/index.html, web/manifest.json | Page title, description, name, short_name |
android/app/src/main/AndroidManifest.xml | android:label |
ios/Runner/Info.plist | CFBundleDisplayName |
macos/Runner/Configs/AppInfo.xcconfig | PRODUCT_NAME and PRODUCT_COPYRIGHT |
The consequences screen also says MIKODES has not verified… (lib/core/token2022/compatibility.dart). If you change that text, regenerate the generated docs so the test suite stays green:
dart run tool/generate_docs.dart
flutter test
03Bundle ID and application ID Required
The package uses com.mikodesforge.app everywhere. Pick your own reverse-domain ID, for example com.yourcompany.tokens, and change it before publishing.
| Platform | Where |
|---|---|
| Android | android/app/build.gradle.kts: namespace and applicationId. Move android/app/src/main/kotlin/com/mikodesforge/app/MainActivity.kt to the matching folder and update its package line. |
| iOS | Xcode → Runner target → Signing & Capabilities, or PRODUCT_BUNDLE_IDENTIFIER in ios/Runner.xcodeproj/project.pbxproj (also the RunnerTests entries). |
| macOS | PRODUCT_BUNDLE_IDENTIFIER in macos/Runner/Configs/AppInfo.xcconfig. |
Google Play and the App Store tie the listing to this ID. It cannot be edited once the app is live.
04Icons and logo
- Header logo:
assets/icon/mikodes_logo.png, drawn at 26 × 26 byForgeMarkinlib/ui/forge_chrome.dart. Replace the file (keep the name, or change the path there). - App icon source:
assets/icon/icon_placeholder.svgis a placeholder on purpose. - Platform icons to regenerate from your artwork (any icon generator; none is bundled):
android/app/src/main/res/mipmap-*/ic_launcher.pngios/Runner/Assets.xcassets/AppIcon.appiconset/macos/Runner/Assets.xcassets/AppIcon.appiconset/web/icons/,web/favicon.png,web/favicon-64.png
05Colours
All colours are in ForgePalette in lib/ui/theme.dart. The single accent is accent (0xFFE8B04B, amber) with accentPressed and accentSoft. The dark grounds are ground, surface, raised and overlay. The web splash colours are background_color and theme_color in web/manifest.json.
Red, amber and violet mark cannot happen, costs and venue policy, unverified. Change the accent freely, but keep those three distinguishable; they carry information.
The UI uses system fonts (SF Pro, Segoe UI, Roboto and others as fallbacks, lib/ui/terminal/terminal_tokens.dart); no font file is bundled.
06After rebranding
flutter clean
flutter pub get
flutter analyze
flutter test
Then run the app and check the header, the browser tab and the Settings → Effective configuration screen.