1
Login via OAuth
Editor opens /admin. Self-hosted auth gateway redirects to GitHub and returns a CMS token.
Auth: self-hosted OAuth
Production engineering showcase
Steal my self-hosted WebApp template for FREE
Dockerized SSR sites with GitHub OAuth CMS, CI/CD via GitHub Actions, and optional Notion, Supabase, Resend, and Cal.com integrations.
Walkthrough
See the stack in action
Short walkthrough of deploy, CMS auth, and integrations.
Try it yourself
Live integration sandbox
Simulate a lead form pipeline through demo Supabase and Notion, same integration pattern as production.
…
Leads captured
…
Failed
…
Avg capture time
…
- …
pipeline
Add a lead to see pipeline output.
The deploy pipeline from CMS to VPS
Login via OAuth
Editor opens /admin. Self-hosted auth gateway redirects to GitHub and returns a CMS token.
Auth: self-hosted OAuth
Edit in Decap CMS
Content changes in the visual editor. No third-party auth SaaS.
Commit to GitHub
Decap saves to the repo branch: develop for test, main for production.
GitHub Actions deploy
Workflow SSHs into the VPS, pulls latest code, and triggers a rebuild.
CI: GitHub Actions
Docker rebuild on VPS
Multi-stage build, compose up on the shared web-public network.
Runtime: Docker + Astro SSR
Live site updated
Nginx Proxy Manager routes TLS. Astro SSR serves the new build.
2
Edit in Decap CMS
Content changes in the visual editor. No third-party auth SaaS.
3
Commit to GitHub
Decap saves to the repo branch: develop for test, main for production.
4
GitHub Actions deploy
Workflow SSHs into the VPS, pulls latest code, and triggers a rebuild.
CI: GitHub Actions
5
Docker rebuild on VPS
Multi-stage build, compose up on the shared web-public network.
Runtime: Docker + Astro SSR
6
Live site updated
Nginx Proxy Manager routes TLS. Astro SSR serves the new build.
Stack capabilities
Astro SSR + Design System
Server-rendered pages, i18n routing, typed content collections, and a full component library.
Rendering: Astro SSR Locales: 4
Multi-locale SSR article CI/CD + Docker
GitHub Actions SSH deploy, multi-stage Docker builds, and rolling image tags for VPS rollback.
Deploy: 2 containers
Production deploy guide Business Integrations
Optional Notion CRM, Resend email, Supabase analytics, and Cal.com, wired through typed API routes.
Lead funnel articleLive deployments
Production sites running on the same VPS platform this stack powers.
SSR Integrations i18n
Iluro Digital
Agency site with Supabase analytics, Notion CRM, Resend, and Cal.com booking.
Decap CMS Docker GitHub Actions
Da Sandro Mataró
Restaurant CMS with Decap content editing and multi-locale menu collections.
Frequently asked questions before we start
What is Astro Business Stack?
A production-ready template for marketing sites: Astro 6 SSR, Docker, self-hosted GitHub OAuth for Decap CMS, GitHub Actions deploys to a VPS, and optional Notion, Supabase, Resend, and Cal.com integrations.
Can I run it without a VPS?
Yes. Use `pnpm dev` locally for development. Docker Compose runs the same app and auth-gateway containers you deploy to production.
How does the CMS authentication work?
Decap CMS loads at `/admin`. A separate Express gateway container handles GitHub OAuth and returns a token to the CMS — no third-party auth SaaS required.
Are integrations required?
No. Each integration is optional and controlled via environment variables. The site runs without Notion, Supabase, or Resend; lead flows degrade gracefully.
What upstream project is this based on?
The UI foundation comes from Southwell Velocity (Astro 6 + Tailwind v4). This repo adds VPS deployment, OAuth gateway, CI/CD, and business integrations.
Ready to deploy the stack
Clone the repository, follow the docs, and adapt the pattern to your own VPS or client projects.