Recipes
Rebrand the Product
Rebrand app identity, AI identity, and baseline visual settings via env-driven configuration.
This recipe applies a full product identity refresh without changing core architecture.
Fast path
For most teams, branding updates require env changes only; no package-level refactors are needed.
Rebrand Workflow
Copy env templates (if missing)
cp .env.example apps/app/.env
cp .env.example apps/admin/.env
cp .env.example apps/web/.envSet branding variables
Add or update these in env files:
NEXT_PUBLIC_APP_NAME="Your App Name"
NEXT_PUBLIC_APP_NAME_SHORT="AppName"
NEXT_PUBLIC_APP_TAGLINE="Your Tagline"
APP_AI_NAME="Your AI Assistant"
APP_AI_IDENTITY="an AI designed for your use case"
NEXT_PUBLIC_AI_GREETING="Hello! How can I help?"
NEXT_PUBLIC_SUPPORT_EMAIL="support@yourcompany.com"
NEXT_PUBLIC_COMPANY_NAME="Your Company"
NEXT_PUBLIC_LOGO_INITIAL="Y"
NEXT_PUBLIC_PRIMARY_COLOR="#0066FF"
NEXT_PUBLIC_PREMIUM_TIER_NAME="Pro"Restart local runtime
bun devVerify visible changes
Validate title/header/footer text, AI identity and greeting copy, marketing metadata, and premium tier naming.
Optional Deeper Customization
- translation strings in app message files
- UI theme tokens in shared UI styles
- logo asset replacement in app public assets