Configuration

Overview

Configuration happens in three layers:

1. Environment — .env (SITE_NAME, SITE_SLUG, PAYLOAD_*, R2_*)
2. Site settings — sites/{name}/settings.ts or Payload (topNav, footer, logo, theme)
3. VitePress config — .vitepress/config.ts (srcDir, transformPageData, aliases)

Configuration layers

• Environment Variables — Which site to load, Payload vs local, asset URLs
• Site Settings — Navbar, footer, logo, theme, form endpoints
• VitePress Config — Build options, SEO, transformPageData