Rebrand

Rebrand

Apply a downstream brand to a PlatformPlatform fork. The rebrand is intentionally narrow: brand values live in one JSONC file, logo assets live at canonical paths, and a handful of names (solution file, CLI alias, UserSecretsId, Docker prefix) flip in lockstep. Source code is not touched.

This skill expects the upstream canonical layout — primary logos named logo-{light,dark}-88.png and square marks named logo-mark-{light,dark}-192.png. If you are on an older PlatformPlatform that still uses logo-wrap-* or -512 mark names, the upstream needs the one-time rename first.

STEP 1: Verify a clean working tree

git status --porcelain

Stop if there is anything staged or unstaged. Rebrand touches many files at once and a mid-rebrand merge with unrelated changes is hard to untangle.

STEP 2: Collect inputs

Use AskUserQuestion to collect all values up front. Do not write anything until every value is in hand — otherwise a partial rebrand leaves the fork in a broken state.

Required inputs:

1. Product name — proper-cased product label shown in UI, emails, page titles. Example: Acme.
2. CLI alias — short lowercase shell alias replacing pp. Example: acme. No spaces, no dashes inside the binary name.
3. Solution name — base filename for PlatformPlatform.slnx. Example: Acme (yielding Acme.slnx).
4. Internal email domain — @example.com (leading @ required). Classifies users as internal for telemetry segmentation. BackOffice access is controlled by Entra ID, not by this setting.
5. Taglines — one-line product descriptions split across two channels and per locale:
   • tagline.web.<locale> — shown in the landing page footer (consumer reads the active Lingui locale).
   • tagline.mail.<locale> — shown in the email footer (renderer reads the template's locale). The two maps must list the SAME locales (backend fails loud at startup if they diverge); the en-US value is REQUIRED. Collect en-US and da-DK for both channels — for downstream brands the web and mail copy will often differ (e.g. the email leans toward the recipient context). For PlatformPlatform itself, web == mail.
6. Primary color — four CSS color expressions (oklch / hex / hsl / rgb all valid) under branding.primaryColor: light, lightForeground, dark, darkForeground. Drives the "button color" and its on-color text in both light and dark modes. The value flows through theme.css via an inline <style> block injected per HTML template (--brand-primary / --brand-primary-foreground CSS variables); --primary and --sidebar-primary read those. Pick foregrounds with enough contrast against the primary — that is a deliberate brand-owner decision, not auto-derived.
7. PWA chrome colors — hex only, no oklch. branding.themeColor.light / branding.themeColor.dark tint the mobile browser/PWA toolbar (iOS Dynamic Island "tint band"); the frontend swaps the <meta name="theme-color"> value at runtime to match the resolved theme. branding.themeColor.light is the install-time fallback baked into manifest.json (PWA spec is single-valued). branding.backgroundColor is the PWA splash-screen background while the SPA boots.
8. Email header background — single CSS color (hex / rgb) used behind the transparent email banner PNG at the top of every transactional email. Same value in light- and dark-mode email clients, so pick a color that reads well in both contexts. Field: branding.emailHeaderBackground.
9. Contact email — public-facing email shown as a mail icon in landing page footer. Empty hides it.
10. Support email — shown to signed-in users in the in-app support dialog. Required (the dialog renders the value unconditionally; an empty string shows a blank field).
11. Show Add to Home Screen — branding.showAddToHomescreen boolean. When true the user-facing app renders the iOS "Add to Home Screen" install prompt (it self-limits to iOS Safari outside an installed PWA); false suppresses it entirely. BackOffice never shows the prompt regardless.
12. Social links — six separate fields: GitHub, LinkedIn, YouTube, X, Facebook, Instagram. Each is a full URL or empty string.

Required logo assets (user provides absolute paths to eight files):