Customization
Branding, theme colors, and navigation — without touching code
Branding via environment variables
Set these in .env (all optional):
| Env var | Purpose |
|---|---|
VITE_APP_NAME | Brand name in the top nav and page titles |
VITE_APP_LOGO | Logo URL shown next to the name |
VITE_APP_URL | Canonical URL of this docs site |
VITE_SITE_URL | "Website" link back to your main product site |
Legacy NEXT_PUBLIC_* names are also accepted, so an existing ShipAny
.env can be reused as-is.
Theme colors
The whole palette lives in one file: src/styles/theme.css, in standard
shadcn/ui variable format (:root + .dark blocks).
To swap themes, pick any theme on tweakcn.com
(or any shadcn theme), copy its CSS variables, and paste them into
theme.css. No other file changes.
If you work with Claude Code, the repo ships an update-theme skill:
/update-theme apply the tweakcn "vercel" themeNavigation
The top nav title/logo and external links are defined in
src/lib/layout.shared.tsx (baseOptions). By default it shows your
brand (from env vars) and a "Website" link when VITE_SITE_URL is set.
Search
Full-text search works out of the box (Orama, via /api/search).
Chinese content is indexed too — no configuration needed.