Introduction

What is it?

This VitePress template is a block-based static site generator. You define pages as arrays of content blocks (hero, rich text, cards, forms, etc.), and the template renders them into a full site with layouts, navigation, and SEO.

Key features

• Block-based content — 21 block types: hero, rich text, image, accordion, tabs, forms, pricing tables, events, and more.
• Dual data sources — Build from local TypeScript site definitions (sites/{name}/) or from Payload CMS.
• Layouts — Landing (full-width hero), standard (breadcrumbs, container), and docs (sidebar, TOC, prev/next).
• SEO — Per-page meta titles, descriptions, OG images, canonical URLs via transformPageData.
• Cloudflare Pages — Deploy with wrangler; site config drives domain and account.

Data sources

You choose one at build time:

• Local — Set SITE_NAME=showcase (or another site in sites/). Pages and settings come from TypeScript files.
• Payload CMS — Set SITE_SLUG=your-site. Pages and settings are fetched from the Payload API.

Both paths produce the same output: VitePress pages with blocks, layouts, and SEO.

Who is it for?

Developers building marketing sites, documentation sites, or content-heavy pages. The block system keeps content structured while the dual data sources let you prototype locally and switch to a CMS when needed.

Next: Installation → Quick Start → Project Structure