v0 — convention-first monorepo

Build full-stack apps at lightning speed

Astro 5 SSR, Vue 3 islands, Tailwind 4, design tokens, Better Auth, and an optional .NET 10 backend — all wired together with sensible defaults so you can focus on shipping.

Get Started GitHub

Boot Sequence

bash

$ git clone https://github.com/codywilliamson/shockstack my-app

$ cd my-app && pnpm install

$ dotnet run --project backend/src/ShockStack.AppHost

-> postgres running on port 5432

-> api ready on https://localhost:7275

-> frontend ready on http://localhost:4321

check aspire dashboard on http://localhost:15888

Everything you need, nothing you don't

Batteries included where it matters. Every piece is optional, swappable, and documented.

Astro 5 SSR

Island architecture with server-side rendering. Deploy to Cloudflare Workers or Docker.

Vue 3 Islands

Interactive components hydrate on demand. Ship zero JS by default, add reactivity where needed.

Design Tokens

Style Dictionary v5 generates CSS vars, Tailwind config, TS constants, and JSON from a single source.

Better Auth

Email/password and OAuth out of the box. JWT validation shared with the .NET backend.

.NET 10 Backend

Optional clean architecture API with EF Core, Aspire orchestration, and shared auth.

Tailwind 4

Latest Tailwind with Vite plugin integration. Token-powered theme with fourteen built-in palettes.

CI/CD Pipeline

GitHub Actions with semantic-release, commitlint, and automated deployments baked in.

Docker Ready

Multi-stage Dockerfiles, compose configs, and Aspire AppHost for single-command orchestration.

The stack, visualized

A layered architecture where every piece is independently useful.

Frontend

Astro 5 Vue 3 Tailwind 4 reka-ui

Shared

Design Tokens Better Auth Drizzle ORM JWT

Backend

.NET 10 EF Core Aspire Clean Arch

Infra

Docker Turborepo GitHub Actions Postgres

Planning Use Cases

Pick the setup you actually need

See all use cases →

B2B SaaS Dashboard

Build an authenticated product UI with fast docs/marketing routes and interactive account features.

public marketing routes stay fast
private dashboard ships only needed JS

Include

Astro SSR Vue Islands Tailwind v4 Design Tokens Better Auth Drizzle ORM

Internal Ops Portal

Ship admin tools for support, billing, and reporting with stronger backend boundaries.

clear domain/service layers
durable audit-friendly APIs

Include

Astro SSR Vue Islands Tailwind v4 Design Tokens Better Auth .NET 10 API .NET Aspire AppHost Docker Compose

Content + Docs Platform

Run docs, changelog, and blog content with optional light interactivity and theme controls.

SEO-first static content
clean writing workflow via content collections

Include

Astro SSR Tailwind v4 Design Tokens

Developer experience first

Clean APIs, sensible defaults, and code that reads like documentation.

tokens/dracula.json

{
  "color": {
    "accent": {
      "purple": {
        "$value": "#bd93f9"
      },
      "pink": {
        "$value": "#ff79c6"
      },
      "green": {
        "$value": "#50fa7b"
      }
    }
  }
}

Define once — generate CSS vars, Tailwind config, TS constants

pages/index.astro

---
import BaseLayout from "../layouts/BaseLayout.astro";
import Counter from "../components/Counter.vue";

export const prerender = true;
---

<BaseLayout title="Home">
  <h1 class="text-accent-purple">
    Hello ShockStack
  </h1>
  <Counter client:visible />
</BaseLayout>

Astro components with Vue islands that hydrate on demand

Quick Start

bash

# clone and install

$ git clone https://github.com/codywilliamson/shockstack my-app

$ cd my-app && pnpm install

# build design tokens

$ pnpm tokens:build

# start full stack (postgres, api, frontend, dashboard)

$ dotnet run --project backend/src/ShockStack.AppHost

# frontend-only development

$ pnpm --filter frontend dev

About this project

Why ShockStack?

ShockStack was born from years of building production apps and wanting a single, opinionated starting point that actually works. No starter-kit bloat, no half-baked integrations — just the patterns that have proven themselves in real projects, wired together with sensible defaults.

Built by Spectacle

ShockStack was developed by Spectacle Software for use across client projects and internal tools. It represents the distilled best practices from building modern full-stack applications for businesses of all sizes.

Ready to build something?

ShockStack gives you the architecture so you can focus on the product. Clone, customize, ship.

Read the Docs Star on GitHub

Need a team to build it for you?

Let Spectacle Software handle it

The team behind ShockStack builds custom web applications, APIs, and full-stack platforms for businesses. Same stack, same quality — tailored to your needs.

Get in Touch