Zum Inhalt springen

Produktionsreifer Astro 6.3 Monorepo-Starter

Cloudflare Workers, Tailwind v4, Svelte 5 und alles, was ein modernes Projekt von Anfang an braucht. MIT-lizenziert, deploy-bereit.

Starter Demo Blog Demo
Astro 6.3 Tailwind v4 Svelte 5 TypeScript Cloudflare Workers Biome Zod v4 i18n CSP Playwright pnpm Workspaces MIT

In drei Schritten starten

1. Repository klonen (oder als GitHub Template nutzen)

git clone https://github.com/casoon/astro-v6-template
cd astro-v6-template

2. Abhängigkeiten installieren

pnpm install

3. Entwicklungsserver starten

pnpm dev          # starter App
pnpm dev:blog     # blog App
Voraussetzung: Node.js 22.12.0+ und pnpm 10+

Struktur

astro-v6-template/
├── apps/
│   ├── starter/          # Landing page + Kontaktformular + i18n
│   └── blog/             # MDX Blog + Content Collections + RSS
├── shared/               # Design Tokens, UI-Komponenten, Utilities
├── e2e/
│   ├── starter/          # Playwright E2E-Tests für starter
│   └── blog/             # Playwright E2E-Tests für blog
├── .github/workflows/    # CI-Pipeline + Badge-Updates
├── biome.json            # Lint + Format für den gesamten Workspace
├── CLAUDE.md             # Claude Code Guidelines + Skills
├── pnpm-workspace.yaml
└── package.json          # Workspace-Root mit pnpm Catalog

Neue Apps lassen sich mit einem Ordner unter apps/ hinzufügen. Alle Apps teilen sich Design Tokens und Komponenten aus dem shared-Package.

Was drin steckt

Astro 6.3 + Vite 7

Dev-Server mit Vite Environment API. workerd läuft lokal identisch zur Production-Umgebung auf Cloudflare.

Tailwind CSS v4

CSS-first Konfiguration, Vite-Plugin, OKLCH-Farben und Dark Mode. Kein JavaScript in der Config.

Svelte 5 Runes

Reaktive Inseln mit der neuen Runes-API ($state, $derived). Kein unnötiger Client-JavaScript-Overhead.

Cloudflare Workers

Cloudflare-Adapter mit Sessions via KV – lokal und in Production identisch. Wrangler 4, Cache-Headers und Security-Headers inklusive.

Biome

Ein Tool für Linting und Formatierung. Ersetzt ESLint + Prettier vollständig. Schneller, weniger Konfiguration.

Zod v4

Runtime-Validierung für Environments, Formulare und API-Routen. Direkt in Astro Actions integriert.

Features

pnpm Workspaces Monorepo

starter + blog als eigenständige Apps, geteilte Design Tokens und UI-Komponenten im shared-Package.

i18n (en/de)

Mehrsprachigkeit mit Astro i18n-Routing. Default-Locale ohne Prefix, vollständig hreflang-konform.

Content Security Policy

CSP mit SHA-256 direkt in Astro konfiguriert. Keine externe Middleware nötig.

OG Images

Automatisch generierte Open Graph Images zur Build-Zeit mit Satori + resvg.

Astro Actions

Server-seitige Formularverarbeitung für Kontakt, Newsletter und Feedback – typsicher mit Zod v4.

Playwright E2E

28 Tests für beide Apps inkl. axe-core Accessibility-Scans. Läuft in CI automatisch.

Post-Build Audit

@casoon/astro-post-audit prüft nach jedem Build SEO, A11y, Links, hreflang und Sitemap.

Secret Scanning

@casoon/nosecrets im Pre-commit und als manueller Workspace-Scan. Keine Secrets im Repository.

Astro Sessions

Server-seitiges Session-Management via Cloudflare KV – fertig konfiguriert, sofort nutzbar.

RSS Feed

Die Blog-App generiert automatisch einen RSS-Feed unter /rss.xml – inkl. aller Metadaten aus den Content Collections.

Claude Code Integration

CLAUDE.md mit Projekt-Guidelines, Skills und MCP-Server-Konfiguration – sofort einsatzbereit für KI-gestütztes Entwickeln.

Dark Mode

System-Präferenz + manueller Toggle via prefers-color-scheme. OKLCH-Farben behalten in beiden Modi ihren Kontrast.

Site Files

@casoon/astro-site-files generiert robots.txt, sitemap.xml, llms.txt, security.txt und humans.txt zur Build-Zeit.

Deployment

Cloudflare Workers

wrangler deploy

Der Cloudflare-Adapter generiert direkt Worker-kompatiblen Output. Sessions, KV und R2 sind fertig konfiguriert. 

pnpm build:starter
pnpm deploy:starter
Andere Plattformen

Adapter tauschen

Astro unterstützt Vercel, Netlify, Node.js und andere Plattformen. Adapter austauschen, fertig. 

pnpm add @astrojs/vercel
# adapter in astro.config.mjs ändern

Geeignet für

Marketing-Websites
Blog + Content-Seiten
Agentur-Starter
Cloudflare-Projekte
Multi-App Monorepos
Open-Source-Templates

Warum Astro – und warum ein Template?

Astro rendert statisches HTML. JavaScript kommt nur dort in den Browser, wo es durch eine explizite Island eingebunden wurde – das Ergebnis sind schnelle Ladezeiten ohne manuelles Optimieren. Der Cloudflare-Adapter erzeugt echte Workers, die lokal unter workerd identisch zur Production laufen.

Wer ein Astro-Projekt neu aufsetzt, verbringt die ersten Tage regelmäßig mit denselben Aufgaben: Monorepo-Struktur anlegen, i18n konfigurieren, CSP einrichten, Linting aufsetzen, Tests integrieren. Dieses Template erledigt das ein für alle Mal – damit der erste Commit Produktions-Code enthält, nicht Boilerplate.

Für wen ist dieses Template?

Entwickler, die Zeit sparen wollen

Biome, Playwright, i18n, CSP, Cloudflare und Post-Audit sind fertig konfiguriert. Der erste Commit enthält Produktions-Code, nicht Boilerplate.

Agenturen & Freelancer

Ein solides Basis-Template für alle Cloudflare-Projekte. Neues Projekt – neuer Ordner unter apps/. Die gesamte Werkzeugkette ist bereits da.

Teams mit Qualitätsanforderungen

WCAG-Konformität, Secret Scanning, E2E-Tests und Build-Audits sind von Anfang an eingebaut – nicht nachträglich dazugebaut.

Mehrsprachige Projekte

i18n ist Teil der Architektur: Astro i18n-Routing, hreflang-Validierung nach jedem Build, getrennte Inhalte pro Locale.

CASOON Open-Source-Plugins

Das Template kommt mit vier Open-Source-Plugins von CASOON – alle fertig konfiguriert, alle MIT-lizenziert. Sie bilden eine Werkzeugkette, die typische Qualitätsprobleme im Astro-Workflow automatisch abfängt.

Build-Qualität

@casoon/astro-post-audit

Prüft SEO, Accessibility, hreflang und JSON-LD nach jedem Build. Fehler blockieren den Build bevor sie live gehen.

Site-Dateien

@casoon/astro-site-files

Erzeugt robots.txt, sitemap.xml mit i18n-hreflang, llms.txt, security.txt und humans.txt beim Build. Kein manuelles Pflegen.

Security

@casoon/nosecrets

Verhindert, dass API-Keys und Tokens ins Repository gelangen – als Pre-commit-Hook und manueller Workspace-Scan.

Performance

@casoon/astro-speed-measure

Misst Build-Performance auf Ebene von Integrations, Vite-Plugins und Pages. JSON-Baseline, CI-Summaries und Trend-Vergleiche inklusive.

Im Insights-Blog

Astro v6 Template: Von Grund auf neu gebaut – was sich gegenüber v5 ändert

Entscheidungen, Umbauten und was aus v5 mitgenommen wurde – ein Überblick über Architektur und Toolchain des Templates.