Astro 6 + Tailwind v4 Starter

Astro Performance Starter.

Point your AI agent at the docs and ship.

Build blazing-fast websites with Astro's zero-JS architecture — 95+ Lighthouse scores out of the box. Ships with implementation guides, Claude Code skills, and context docs for your coding agent.

  • Included: TypeScript strict mode
  • Included: CSS-native Tailwind config
  • Included: View Transitions built-in

Quality Metrics

Lighthouse for runtime performance · Stryker for test-quality verification (ADR-042)

  • 95+
    Performance
  • 100
    Accessibility
  • 100
    Best Practices
  • 100
    SEO

Scores reflect ideal conditions (empty starter). Real-world results may vary by deployment and content.

Why Choose This Template?

Six production-tested capabilities — from zero-JS performance to AI-ready documentation — ready to customise from day one.

Performance-First Architecture

95+ Lighthouse

Zero-JS baseline with islands architecture. Ships with 95+ Lighthouse and CI/CD performance budgets.

Show details Hide details
  • Static site generation with selective hydration for optimal performance
  • Automatic code splitting and lazy loading for JavaScript components
  • Built-in image optimization with WebP/AVIF conversion
  • Performance budgets enforced in CI/CD pipeline
  • Core Web Vitals monitoring and optimization

Agentic Discipline Built In

Halt-on-Violation

Layered AI constitution, role-separated workflow, and halt-on-violation CI gates. Your agent works under the same rules you do.

Show details Hide details
  • Layered constitution: CLAUDE.md + .claude/engineering.md + .claude/workflow.md + .claude/stack.md
  • Role-separated workflow: Architect plans, Coder implements, Reviewer verifies (.claude/roles/)
  • pnpm quality:ci halts on any violation — broken tests, lint, types, and markdown all block merge
  • Every AI-readable rule names its halt condition with a stated reason, not soft guidance
  • Pattern source: Uncle Bob's Clean AI: Agentic Discipline series

Enterprise-Grade Design System

WCAG AA

Semantic design tokens with automatic dark mode, WCAG AA compliance, and automated contrast validation.

Show details Hide details
  • Semantic color tokens that automatically adapt to light/dark themes
  • WCAG AA contrast ratio validation in build process
  • Consistent spacing, typography, and color scales
  • Automated design token generation from source files
  • Theme switching with system preference detection
  • CSS @theme inline — tokens live in CSS, no JS config file

Next-Gen Opinionated Toolchain

20x Faster

Biome replaces ESLint + Prettier with 20x speed. Tailwind v4 CSS-native config. TypeScript strict mode and automated quality gates.

Show details Hide details
  • Biome replaces ESLint + Prettier with 20x performance improvement
  • TypeScript strict mode catches errors before they reach production
  • Git hooks for automated code quality checks
  • Conventional commits with automated changelog generation
  • Dependency vulnerability scanning and updates

Production-Ready Components

Type-Safe

Battle-tested atomic design system with accessible primitives, responsive layouts, and TypeScript interfaces.

Show details Hide details
  • Atomic design methodology: atoms, molecules, organisms, templates
  • Accessible components with proper ARIA attributes
  • Responsive design patterns built into every component
  • TypeScript interfaces for type-safe component props
  • Reusable structural components for consistent layouts

Robust Page Templates

Ready to Ship

Portfolio-ready pages included: About, Projects, Blog, Contact. Launch with professional content, not empty shells.

Show details Hide details
  • Professional About page with skills showcase and responsive design
  • Projects portfolio with grid layouts and detailed case studies
  • Blog system with MDX support and content collections
  • Contact forms with Cloudflare Pages integration
  • Responsive navigation and footer components

What You Get on Clone

Foundation is done. Build has demo content ready to replace. Polish guides you to production.

✅ Done

Foundation

Architecture, tooling, and design system — pre-configured and working. You never touch this unless you're making architectural changes.

  • Included: Astro + TypeScript + Tailwind + Biome
  • Included: Content Collections schemas
  • Included: Design tokens system
  • Included: Layered AI constitution (CLAUDE.md + .claude/)
  • Included: Halt-on-violation CI gates

Clone the repo and this is already running.

📦 Demo Included

Build

Components, page templates, blog posts, and case studies — all built with real content. Replace the demo content with your own brand and copy.

  • Included: Atoms, molecules & organism components
  • Included: Page templates for every section
  • Included: Blog, projects & case study content
  • Included: Container API microtests for every atom & molecule
  • Included: Test-first discipline enforced in CI (ADR-037)

Your agent works under the same constitution — every component has a contract test.

📋 Guided

Polish

Performance budgets, deployment configuration, and monitoring. Follow the implementation guides when you're ready to go live.

  • Included: Performance budget enforcement
  • Included: Deployment configuration
  • Included: Documentation and AI context
  • Included: Mutation testing as quality verification (ADR-042)

Each phase has a clear scope — go as far as your project needs.

Modern Tech Stack

Carefully selected tools for optimal developer experience

Framework

Astro

v6

Content Layer API, View Transitions, Islands

Type-safe content, named view transitions, selective hydration

Language

TypeScript

v5

Type-safe JavaScript with strict mode

Catch errors early, better DX

Styling

Tailwind CSS

v4

CSS-native config — no tailwind.config.js

@theme in CSS, Lightning CSS compiler, zero JS config overhead

Tooling

Biome

v2

All-in-one toolchain for web projects

20x faster than ESLint + Prettier combined

Interactivity

Preact

v10

Lightweight React alternative

3KB runtime, familiar React-like syntax

E2E Testing

Playwright

v1

End-to-end testing

Reliable cross-browser testing automation

Unit Testing

Vitest

v4

Fast unit testing powered by Vite

Lightning-fast test execution and hot reload

Component Testing

Astro Container API

experimental_

Microtests for every .astro atom and molecule

Sub-second component-contract verification (ADR-040)

Mutation Testing

Stryker

v9

Mutation testing nightly via GitHub Actions

Verifies tests actually fail when code breaks (ADR-042)

Image Processing

Sharp

v0.34.x

High-performance image processing

Automatic conversion, responsive images

Why This Stack?

Performance First

Every tool chosen prioritizes speed and efficiency, from Astro's zero-JS baseline to Biome's 20x faster linting.

Developer Experience

Modern tooling with TypeScript strict mode, hot reload, and comprehensive testing ensures productive development.

Production Ready

Battle-tested tools used by major companies, with strong community support and active maintenance.

Future Proof

Latest versions of stable technologies that will continue to evolve with web standards.

Clone it. Own it. Ship it.

One clone. Astro 6, Tailwind v4, and a layered AI constitution with halt-on-violation gates — ready to go.

MIT Licensed Astro 6 + Tailwind v4 Agentic Discipline

From the Blog

Latest thoughts on Astro, performance, and modern web development.