MAKE IT YOURS

Your name. Your colours.
Your workspace.

Start with an example or bring your own logo. See your brand across the app, then take the config and assets with you.

Fictional example brands. Pick one to explore, or upload your own logo below.

1. Identity & logo

Brand IDShort machine name. Becomes the folder brands/<id>/ and the default CLI, scheme, state directory and artifact names.App nameHuman-readable product name shown in window titles, menus and the installer.Application IDReverse-DNS bundle ID used for macOS, iOS, Android and Windows. At least three lowercase dot-separated parts; hard to change after release.Daemon portLocal port the background daemon listens on. Pick something unique so your app can run beside Frogg (9999).PublisherCompany or person shown as the publisher in installers and OS dialogs. Should match your code-signing certificate.

Logo · SVG (any size) or PNG, up to 20 MBSVG gives the sharpest icons. Non-square artwork is centered on its content and padded to a square; PNGs under 1024 px are upscaled.Choose the logo to include in your brand folder.

Files stay in this browser. Generated platform icons come from this logo.

2. App colours

Dark appearance

Accent#c4b5fdButtons, selection and focus rings. Needs 4.5:1 contrast with Text on accent.Text on accent#27143dText and icons drawn on top of the accent colour.Background#20152eMain window background. Needs 4.5:1 contrast with Text.Text#faf5ffPrimary text colour on the background.Bright accent#ddd6feHover and highlight variant of the accent. Optional; defaults to Accent.

Light appearance

Accent#6d28d9Buttons, selection and focus rings. Needs 4.5:1 contrast with Text on accent.Text on accent#ffffffText and icons drawn on top of the accent colour.Background#faf5ffMain window background. Needs 4.5:1 contrast with Text.Text#27143dPrimary text colour on the background.Bright accent#7c3aedHover and highlight variant of the accent. Optional; defaults to Accent.

3. Companion

Primary colour#A826FFMain colour of the Companion animation.Secondary colour#06E0FFAccent colour of the Companion animation.

Cloud density65%0-100%. Affects only the Companion animation.Drift speed30%0-100%. Affects only the Companion animation.Secondary colour balance30%0-100%. Affects only the Companion animation.Bloom55%0-100%. Affects only the Companion animation.Voice response25%0-100%. Affects only the Companion animation.

Voice response controls the visual pulse, not microphone sensitivity or audio volume.

4. Links & hosting (optional)

websiteMarketing homepage linked from About and menus.supportWhere users report problems.docsDocumentation linked from the Help menu.sourceSource code link. Defaults to https://github.com/<distribution.repository>.installerPublic URL of your install script, shown in copy-paste install commands.Pairing URLYour hosted pairing page for connecting phones to a host. Leave blank to disable hosted pairing.Allowed origins (one URL per line)Extra web origins allowed to connect to the daemon, one per line. Origins only: no paths.

Blank values keep the app defaults. Custom brands use their own hosted services.

5. Distribution (optional)

repositoryGitHub repository that hosts your releases, as owner/repo (not a URL). The installer downloads from its releases and the app checks it for updates.updatesHow installed apps update. Default: github-release when a repository is set, otherwise disabled.Updater public keyPublic half of your update signing key (base64). Only needed for tauri-signed. Never paste the private key.Docker imageContainer image for the self-hosted daemon, without a tag (e.g. acme/studio or ghcr.io/acme/studio).Pairing imageContainer image for your self-hosted pairing page, without a tag.iOS store IDNumeric App Store ID (the digits after /id in the App Store URL).Expo project IDUUID of your Expo/EAS project (expo.dev project settings). Needed for mobile builds and push.

Signing keys and account credentials stay in your release environment.

Installer appearance & copy (optional)

taglineShort line under the name in the Windows installer. {name} expands to your app name.BackgroundInstaller window background. Defaults to your dark background.surfacePanels and progress track. Defaults to a mix of dark background and text.TextInstaller text. Needs 4.5:1 contrast with the installer background.mutedForegroundSecondary installer text. Defaults to a dimmed dark-mode text colour.AccentProgress bar and primary button. Defaults to the dark accent.Bright accentProgress highlight. Defaults to the dark bright accent.successShown when installation completes. Default #3fcf8e.dangerShown on errors. Default #f87171.installingInstaller status text. {name} expands to your app name. Blank keeps "Installing {name}".migratingInstaller status text. {name} expands to your app name. Blank keeps "Moving {name} to your account".readyInstaller status text. {name} expands to your app name. Blank keeps "{name} is ready".launchingInstaller status text. {name} expands to your app name. Blank keeps "Launching {name}".elevationRequiredInstaller status text. {name} expands to your app name. Blank keeps "{name} is installed for all users. Approve the administrator prompt…".

Blank values follow your app colours and the default installer wording.

Advanced identity & platform assets

Full nameLonger name for installers and About dialogs. Defaults to App name.DescriptionOne sentence used in package metadata and store listings.CLI commandCommand users type in a terminal. Defaults to the brand ID.Desktop binary nameExecutable file name of the desktop app. Defaults to <id>-desktop.State directoryHidden folder in the user's home directory for config and state. Must start with a dot.Environment prefixPrefix for environment variables (e.g. ACME_STUDIO_HOME). Uppercase with underscores.URL schemeDeep-link URL scheme, e.g. acme-studio://pair. Give the scheme only, without ://.Service nameName of the systemd / Windows service that runs the daemon.Launchd labelmacOS launchd label for the daemon. Reverse-DNS; defaults to <applicationId>-daemon.Artifact prefixPrefix for release file names such as AcmeStudio-1.0.0-mac-arm64.dmg.

ios overrideDerived from your logo unless supplied.foreground overrideDerived from your logo unless supplied.notification overrideDerived from your logo unless supplied.splash overrideDerived from your logo unless supplied.faviconLight overrideDerived from your logo unless supplied.faviconDark overrideDerived from your logo unless supplied.

Live app preview

Acme Studio

mainacme-apiCommit

Add /version endpoint

Edit src/server.js

Edit README.md

Done! I've added the /version endpoint and updated the README. Let me verify it by starting the server.

Shell node src/server.js & curl -s localhost:3000/version

Both endpoints are working:

/health returns {"status":"ok"}
/version returns {"version":"1.0.0"}

Changed src/server.js and README.md.

Worked for 2m 25s

Add a test for the /version route

Sonnet 4.5Always ask

Simulated audio. No microphone access.

6. Take your brand with you

Put the ZIP contents in brands/acme-studio/. It contains your config and every uploaded logo, with matching relative paths.

Generated brand.json

Then check and build in your checkout:

This configures identity, artwork and Companion. Packaging, signing and publication use your normal release setup.

Need the details? See every manifest field and default.

Your name. Your colours.Your workspace.

6. Take your brand with you

Your name. Your colours.
Your workspace.