Token Forge docs
v1.0.0
Live demo Get help
● Set up · White label

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:

FileWhat
lib/app.darttitle: of the app (task switcher, browser tab)
lib/core/config/forge_config.dartDefault brandName (two places: the constructor and fromJson)
lib/features/settings/settings_screen.dartThe Product line in Effective configuration
web/index.html, web/manifest.jsonPage title, description, name, short_name
android/app/src/main/AndroidManifest.xmlandroid:label
ios/Runner/Info.plistCFBundleDisplayName
macos/Runner/Configs/AppInfo.xcconfigPRODUCT_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.

PlatformWhere
Androidandroid/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.
iOSXcode → Runner target → Signing & Capabilities, or PRODUCT_BUNDLE_IDENTIFIER in ios/Runner.xcodeproj/project.pbxproj (also the RunnerTests entries).
macOSPRODUCT_BUNDLE_IDENTIFIER in macos/Runner/Configs/AppInfo.xcconfig.
Permanent after launch

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 by ForgeMark in lib/ui/forge_chrome.dart. Replace the file (keep the name, or change the path there).
  • App icon source: assets/icon/icon_placeholder.svg is 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.png
    • ios/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.

Keep the meaning colours

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.