Astro 6 Boilerplate — A production-ready starter template built on Astro 6 and Tailwind CSS v4.

• 57 components across 7 categories — all accessible, typed, and dark-mode ready
• Design token system with OKLCH colors, fluid typography, and two built-in themes
• SEO toolkit — meta tags, JSON-LD, sitemap, robots.txt, and auto-generated OG images
• Content collections — type-safe blog, pages, authors, and FAQs with Zod validation
• API routes — contact form and newsletter endpoints with validation
• React islands — optional client-side interactivity where needed
• i18n-ready — locale-aware schemas; full i18n via the CLI

# Clone
git clone https://github.com/southwellmedia/velocity.git my-project
cd my-project

# Install (requires Node 22.12+)
pnpm install

# Configure
cp .env.example .env

# Develop
pnpm dev

Or use the CLI for the full experience including i18n:

pnpm create velocity-astro my-project

src/
  components/
    ui/           # 31 UI components (form, data-display, feedback, overlay, etc.)
    patterns/     # 7 composed patterns (ContactForm, SearchInput, StatCard, etc.)
    layout/       # Header, Footer, ThemeToggle, Analytics
    blog/         # ArticleHero, BlogCard, ShareButtons, RelatedPosts
    landing/      # Credibility, TechStack, FeatureTabs, and more
    seo/          # SEO, JsonLd, Breadcrumbs
  content/        # Blog posts, authors, FAQs
  config/         # Site and navigation config
  styles/         # Global CSS and design tokens
  pages/          # Routes, API endpoints, OG image generation

Site config: src/config/site.config.ts — name, description, URL, social links

Design tokens: src/styles/tokens/ — colors, typography, spacing

Themes: src/styles/themes/ — switch between default and midnight, or create your own

Environment: .env — see .env.example for available variables

View all components at /components in development.

1. Fork the repo
2. Create a feature branch
3. Ensure pnpm lint and pnpm check pass
4. Open a PR

MIT — see LICENSE for details.

Links: Docs | CLI | Astro | Tailwind v4

Built by Southwell Media