● 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.
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 0xFFC2410C, a burnt orange). The server's brand.accent (console, Brand) may override it. |
displayFont, bodyFont, helperFont | Font family names: Fraunces (parent headings), Outfit (body), Bricolage (helper side). See step 5. |
supportUrl, privacyUrl, termsUrl | Links shown in Settings. They ship empty, and an empty value hides the row. Fill them in before you publish. |
lifetimeIos, lifetimeAndroid, yearlyIos, yearlyAndroid | Store product ids, empty means "not sold". See Store products. |
apiBaseUrl | Read from --dart-define=API_BASE_URL=... at build time. Do not edit. |
tvClientName | The 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.
- build.gradle.kts: in
app/android/app/build.gradle.ktschangeapplicationIdandnamespacefromcom.mikodes.hometetherto yours, for examplecom.yourcompany.yourapp. - Kotlin folder: rename the folders
app/android/app/src/main/kotlin/com/mikodes/hometetherto match the new id. - Package line: change the
packageline at the top ofMainActivity.ktin that folder. - App label: in
app/android/app/src/main/AndroidManifest.xmlchangeandroid:label(it saysHometether). - Check:
must still finish.cd app flutter build apk --release
033. iOS bundle identifier and name
- Open
app/ios/Runner.xcworkspacein Xcode. - Select Runner, then Signing & Capabilities. Set your Team and your Bundle Identifier. It is stored as
PRODUCT_BUNDLE_IDENTIFIERinios/Runner.xcodeproj/project.pbxproj; the test targetRunnerTestsuses the same id with.RunnerTestsadded. - The home-screen name is
CFBundleDisplayNameinapp/ios/Runner/Info.plist.
044. Pairing link name
The pairing QR code contains hometether://pair?c=CODE. It is built in app/lib/src/ui/screens/invite_screen.dart and read back in app/lib/src/relay/pairing_api.dart. The app reads the code out of any text, so you may rename the scheme in both places or leave it; just keep the two files in agreement.
055. Icon and fonts
- Icon: no icon generator is included and
app/assets/icon/is empty. Replace the launcher icons directly: Android underapp/android/app/src/main/res/mipmap-*(Android Studio: right-clickres, New, Image Asset, does this for you) and iOS inapp/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 inapp/pubspec.yamlunderfonts:, then change the names inbrand.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.dartor the console). - Product ids set, or the paywall switched off.
- Search for leftovers:
and rename what remains, including the server's console branding (console, Brand).grep -ri hometether app/lib app/android/app/src app/ios/Runner app/ios/Runner.xcodeproj