🚀 Orion Kit

Production-ready SaaS template with authentication, payments, analytics, and everything a modern project needs. Perfect for learning modern full‑stack development or starting your next project.

Docs • Getting Started • Architecture • Blog

If this saves you time, please ⭐ the repo.

🎯 What's Included

Apps:

• 🌐 Landing Page (web) — Marketing site
• 📊 Dashboard (app) — Admin app with tasks, billing, analytics & TanStack Query
• 🔌 Serverless API (api) — Next.js 15 Route Handlers with Zod validation
• 📚 Documentation (docs) — Astro‑powered docs with Starlight

Features:

• ⚡ Monorepo — Turborepo for fast builds and caching
• 🔐 Authentication — Custom JWT with protected routes & bcrypt
• 🗄️ Database — Neon Postgres + Drizzle ORM with drizzle‑zod
• 🔄 Data Fetching — TanStack Query with optimistic updates
• 💳 Payments — Stripe subscriptions + webhooks
• 📧 Email — Resend with React Email templates
• 🎨 UI — shadcn/ui + Tailwind CSS v4 + Radix UI primitives
• 📊 Analytics — PostHog tracking + Axiom logging
• ⚙️ Jobs — Serverless cron by default; Trigger.dev background tasks
• 🧪 Testing — Vitest unit tests + Playwright E2E
• 📝 Forms — React Hook Form + Zod validation
• 🌗 Theming — Dark mode with next‑themes

Type‑safe stack: Database Schema → Auto‑generated Types → Shared Packages → API → Frontend

Why this structure

• Separation of concerns — clear boundaries between UI, domain, and data reduce coupling and increase clarity.
• Layered & modular — features are encapsulated in layers/modules, making refactors and tech swaps low-risk.
• Monorepo with shared packages — reusable types/utilities/components drive consistency and avoid duplication.
• End-to-end type safety — a single source of truth for models cuts errors and surfaces issues at compile time.
• Portability & future-proofing — parts can be moved, replaced, or scaled without disrupting the rest.
• Developer experience & speed — monorepo caching, one-command flows, and a predictable layout.
• Testability & observability — isolated interfaces make unit/E2E testing and logging/monitoring straightforward.
• Team-friendly ownership — clear package boundaries enable independent changes without blocking others.

⚡ Quick Start

# 1) Use this template or clone
git clone https://github.com/YOUR-USERNAME/your-project-name
cd your-project-name
pnpm install

# 2) Set up environment variables (see below)

# 3) Initialize database
pnpm db:push

# 4) Start everything
pnpm dev

Optional: Rename “orion-kit” to your own project name in package.json, docs, env files, and the repo name.

Apps running:

• 🌐 Landing: http://localhost:3000
• 📊 Dashboard: http://localhost:3001
• 🔌 API: http://localhost:3002
• 🎨 Studio: https://local.drizzle.studio?port=3003
• 📚 Docs: http://localhost:3004

🔧 What You Need

Required accounts (all have generous free tiers):

Service	Purpose	Free Tier
Neon	Database	0.5GB
Stripe	Payments	No fees
Resend	Email	3k emails
PostHog	Analytics	1M events
Axiom	Logging	500MB/mo

🛠️ Environment Setup

1. Create .env.local files:

cp apps/app/.env.example apps/app/.env.local
cp apps/api/.env.example apps/api/.env.local
cp packages/database/.env.example packages/database/.env

2. Add your API keys (get them from the services above):

apps/app/.env.local:

# API
NEXT_PUBLIC_API_URL=http://localhost:3002

# PostHog
NEXT_PUBLIC_POSTHOG_KEY=phc_...
NEXT_PUBLIC_POSTHOG_HOST=https://app.posthog.com

# Stripe
NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=pk_test_...

apps/api/.env.local:

# Database
DATABASE_URL=postgresql://...

# JWT Authentication
AUTH_JWT_SECRET=your-jwt-secret-key-here

# Stripe
STRIPE_SECRET_KEY=sk_test_...
STRIPE_WEBHOOK_SECRET=whsec_...

# Email (Resend)
RESEND_API_KEY=re_...
FROM_EMAIL=onboarding@resend.dev

# Axiom
AXIOM_TOKEN=xaat-...
AXIOM_DATASET=orion

packages/database/.env:

DATABASE_URL=postgresql://...

📦 Monorepo Structure

App	Port	Description
web	3000	Marketing landing page
app	3001	Dashboard application
api	3002	API backend
docs	3004	Documentation

Package	Description
@workspace/auth	JWT authentication + user management
@workspace/database	Drizzle ORM + Neon + Zod schemas
@workspace/email	Resend + React Email templates
@workspace/types	Shared TypeScript types
@workspace/ui	shadcn/ui + Radix UI components
@workspace/payment	Stripe payments + subscriptions
@workspace/analytics	PostHog tracking + Vercel Analytics
@workspace/observability	Axiom logging + Web Vitals
@workspace/jobs	Trigger.dev background jobs

🏗️ Architecture

Type‑safe monorepo with end‑to‑end types. Database schema generates Zod schemas which flow through shared types to API and frontend.

• Flow: Database → Zod Validation → Types → API Routes → TanStack Query hooks
• Single source of truth: Zod/Drizzle schemas validate on server and provide types on client
• Flexibility: Swap API framework/ORM/UI without breaking contracts
• Benefit: Change schema → get compile‑time errors across the stack

🚀 Commands

pnpm dev               # Start all apps
pnpm db:push           # Push database schema
pnpm db:studio         # Open database GUI
pnpm test              # Run tests
pnpm build             # Build for production

📚 Documentation

For more in‑depth documentation and explanations, please see the official documentation site: https://orion-kit-docs.vercel.app/

• Getting Started: https://orion-kit-docs.vercel.app/getting-started/
• Architecture: https://orion-kit-docs.vercel.app/architecture/overview/

📝 License

MIT

---

Built with ❤️ for developers