Hometether 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 a store refuses an id that already belongs to someone else.

brand.dartapplication idbundle idiconfonts

011. lib/brand.dart

Open app/lib/brand.dart. It holds:

ConstantWhat it does
appName, taglineName and tagline shown inside the app.
accentMain colour (default 0xFFC2410C, a burnt orange). The server's brand.accent (console, Brand) may override it.
displayFont, bodyFont, helperFontFont family names: Fraunces (parent headings), Outfit (body), Bricolage (helper side). See step 5.
supportUrl, privacyUrl, termsUrlLinks shown in Settings. They ship empty, and an empty value hides the row. Fill them in before you publish.
lifetimeIos, lifetimeAndroid, yearlyIos, yearlyAndroidStore product ids, empty means "not sold". See Store products.
apiBaseUrlRead from --dart-define=API_BASE_URL=... at build time. Do not edit.
tvClientNameThe name a Samsung TV shows on its "allow this device" prompt (default Hometether). Change it to your app name.

022. Android application id

Windows users

Run the shell commands on this page in WSL 2 (Ubuntu), not in PowerShell: install Node.js inside WSL for the server commands. Flutter can also run natively on Windows for Android builds; iOS builds need a Mac. macOS and Linux users can ignore this note.

  1. build.gradle.kts: in app/android/app/build.gradle.kts change applicationId and namespace from com.mikodes.hometether to yours, for example com.yourcompany.yourapp.
  2. Kotlin folder: rename the folders app/android/app/src/main/kotlin/com/mikodes/hometether to match the new id.
  3. Package line: change the package line at the top of MainActivity.kt in that folder.
  4. App label: in app/android/app/src/main/AndroidManifest.xml change android:label (it says Hometether).
  5. Check:
    cd app
    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; the test target RunnerTests uses the same id with .RunnerTests added.
  3. The home-screen name is CFBundleDisplayName in app/ios/Runner/Info.plist.

055. Icon and fonts

  • Icon: no icon generator is included and app/assets/icon/ is empty. Replace the launcher icons directly: Android under app/android/app/src/main/res/mipmap-* (Android Studio: right-click res, New, Image Asset, does this for you) and iOS in app/ios/Runner/Assets.xcassets/AppIcon.appiconset (drag your 1024 px image into Xcode's AppIcon slot). Make an icon of your own; do not reuse the shipped one for your listing without checking it suits your brand.
  • Fonts: Fraunces, Outfit and Bricolage Grotesque, all under the SIL Open Font License 1.1, with licence texts in app/assets/fonts/. To change fonts, add the font files there, register them in app/pubspec.yaml under fonts:, then change the names in brand.dart. Keep each font's licence file with the font you ship.

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 (brand.dart or the console).
  • Product ids set, or the paywall switched off.
  • Search for leftovers:
    grep -ri hometether app/lib app/android/app/src app/ios/Runner app/ios/Runner.xcodeproj
    and rename what remains, including the server's console branding (console, Brand).