ShipAI Docs
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/.env

Set 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"

Verify 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

On this page