Skip to content
Astro Business Stack Astro Business Stack
Engineering showcase

A platform, not just a site.

This repository documents and demonstrates a repeatable pattern for client-facing Astro sites: containerized, self-hosted, and deployed via GitHub Actions to a Hetzner VPS.

What it proves

Full-stack delivery with SSR, CMS auth, CI/CD, and optional CRM, analytics, email, and booking integrations — the same pattern used for live agency and client deployments.

Design principles

Repeatable deploys

Branch-to-environment mapping, Docker Compose, and shared networking make adding a new site a known procedure.

Secrets stay on the server

.env lives on the VPS, never in git. GitHub Actions only pulls code and rebuilds containers.

Documented architecture

README and docs/ explain VPS topology, OAuth flow, and integration setup so the engineering story is visible.