Site Settings

Overview

Site settings come from sites/{name}/settings.ts (local) or Payload (when using SITE_SLUG). They're written to .vitepress/data/settings.json at build time.

topNav

topNav: {
  links: [
    { text: 'Home', url: '/' },
    { text: 'Docs', url: '/getting-started' },
    { text: 'Blocks', url: '/home', openInNewTab: true }
  ]
}

Links appear in the navbar. openInNewTab is optional.

footer

footer: {
  columns: [
    { title: 'Docs', links: [{ text: 'Installation', url: '/installation' }] },
    { title: 'Resources', links: [{ text: 'Blocks', url: '/home' }] }
  ],
  copyright: 'Your Company',
  socialLinks: [
    { platform: 'linkedin', url: 'https://linkedin.com/company/you' },
    { platform: 'twitter', url: 'https://twitter.com/you' }
  ]
}

Supported platforms: linkedin, twitter, facebook, email.

logo

String URL or object: { url: string, alt?: string }. Use logoDark for dark mode.

theme

daisyUI theme config: lightEnabled, darkEnabled, defaultTheme, and light/dark objects with CSS variables (base100, primary, etc.).

Other fields

• siteName, siteDescription — Used for SEO and defaults
• domain, cloudflareAccountId — For deployment
• ctaButton — Navbar CTA: enabled, text, shortText, url
• hcaptchaSiteKey, formApiEndpoint — For form blocks

Next: VitePress Config