Centralize branding so a rebrand touches only configuration and assets

[tjementum]

Summary & Motivation

PlatformPlatform's brand identity was hardcoded across the codebase — the product name, colors, logos, emails, taglines, social links, and deployment configuration each carried literal values in source files. Rebranding meant hunting through the backend, the SPA, email templates, infrastructure scripts, and CI workflows.

This change pulls every brand surface behind two things: a single configuration file and a fixed set of logo assets. A rebrand becomes a closed, predictable operation:

• Edit application/platform-settings.jsonc — product name, primary color, PWA theme and background colors, email header background, per-locale taglines, contact and support emails, social links, internal email domain, the "Add to Home Screen" toggle, and the local Docker volume prefix.
• Replace the logo assets in place at their canonical paths — the wordmark and mark in shared-webapp/ui/images, the favicon and apple-touch icons in the public folders, the hero images, and the email banner. File names and dimensions are fixed, so the replacements are drop-in.

The rebrand skill added here documents the full process step by step.

Brand configuration

• Add application/platform-settings.jsonc as the single source of truth — embedded into the backend as an embedded resource and injected into the frontend at build time.
• Wire every brand surface to it: SPA strings, the "Add to Home Screen" prompt, the delete-account support email, transactional email templates, PWA manifests, and HTML and backend API titles (including the Back Office title). The E2E suite reads the product name from the same file, so tests stay green after a rebrand.
• Centralize brand colors through the file — the primary color, the PWA theme and background colors, and the transactional email header background.
• Add per-locale taglines split across web and mail channels, and a showAddToHomescreen flag that gates the iOS install prompt.
• Source the cluster deployment's product name from the same file via deploy-cluster.sh, so deployment branding follows the config with no separate CI variable.

Brand assets

• Centralize brand logos and hero images in shared-webapp/ui/images and remove the duplicated per-app copies. A theme-aware Logo component resolves the light or dark variant automatically and preserves the aspect ratio of non-square marks.
• Make the transactional email header a full-width responsive banner that scales on mobile, and drop the card corner radius on small screens.
• Add dedicated platformplatform-* credit logos, kept separate from the configurable assets so upstream attribution survives a rebrand.

Developer experience

• Make the developer CLI alias and its user-facing messages derive from configuration.
• Centralize the Docker volume prefix in platform-settings.jsonc (development.dockerVolumePrefix), resolved by a shared helper so the Aspire AppHost and the CLI stop command always agree.
• Reorganize the local development port allocation so the browser-facing hosts take the lowest offsets, with a slot reserved for a future web host.
• Move the /components design-system showcase into the back-office so it sits behind authentication, and serve email preview artifacts only there. The preview now renders real brand values instead of stale sample data.
• Fix the account and main staging deploy jobs so they no longer skip when the database migration job is skipped — a change carrying the Deploy to Staging label with no migration changes now deploys to staging as expected.

UI and content fixes

• Constrain the landing and legal pages to a 1024px content width with edge-aligned navigation, restructure the landing page footer, and fix logo sizing in narrow navigation headers and on error pages.
• Remove the region selector from the signup form and the "Built with PlatformPlatform" attribution from the login and verification footers.
• Fix Danish translation errors and adopt the "compliance" loanword.

Minor fixes: remove an orphaned PlatformPlatform.* coverage filter, add a dark-mode apple-touch-icon, replace brand SVGs with PNGs so Safari renders them crisply, track platform-settings.jsonc as a turbo global dependency, and use example.com in illustrative comments.

Checklist

• I have added tests, or done manual regression tests
• I have updated the documentation, if necessary

[sonarqubecloud]

Quality Gate passed

Issues
10 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
2.6% Duplication on New Code

See analysis details on SonarQube Cloud