Quick Start

TL;DR

Clone → Install → Start → Done! Visit localhost:3001 to see your app. Add cloud services when you’re ready to deploy.

Prerequisites

• Node.js 20+ + pnpm (npm install -g pnpm)
• Cloud accounts (all have free tiers):
  • Neon - PostgreSQL database
  • Stripe - Payments
  • Resend - Email service
  • PostHog - Analytics
  • Axiom - Logging
  • Trigger.dev - Background jobs
• Stripe CLI - For local webhook testing

Setup

# 1. Clone & install
git clone <repo-url>
cd orion
pnpm install

# 2. Get API keys from all services
# See /accounts-setup for detailed instructions:
# - Neon (database)
# - Stripe (payments)
# - Resend (email)
# - PostHog (analytics)
# - Axiom (logging)
# - Trigger.dev (jobs)

# 3. Create env 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

# 4. Add keys to .env files (see below)

# 5. Initialize DB
pnpm db:push

# 6. Start Stripe CLI for webhooks (in new terminal)
stripe listen --forward-to localhost:3002/webhooks

# 7. Start everything
pnpm dev

Environment Variables

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_...
NEXT_PUBLIC_STRIPE_PRICE_ID_PRO=price_...
NEXT_PUBLIC_STRIPE_PRICE_ID_ENTERPRISE=price_...

apps/api/.env.local:

# JWT Authentication
AUTH_JWT_SECRET=your-super-secret-key-min-32-chars

# Database
DATABASE_URL=postgresql://...

# 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

# Trigger.dev
TRIGGER_SECRET_KEY=tr_dev_...

packages/database/.env:

DATABASE_URL=postgresql://...

See Accounts Setup for detailed instructions on getting all API keys.

Running Apps

App	Port	URL
Web	3000	http://localhost:3000
App	3001	http://localhost:3001
API	3002	http://localhost:3002
Studio	3003	https://local.drizzle.studio?port=3003
Docs	3004	http://localhost:3004

Visit http://localhost:3001 → Sign up → Create tasks!

Commands

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

Troubleshooting

Issue	Fix
”Unauthorized”	Sign in at http://localhost:3001/login
CORS errors	Check NEXT_PUBLIC_API_URL in app/.env.local
DB connection	Verify DATABASE_URL uses pooled connection
Stripe webhooks	Ensure Stripe CLI is running with stripe listen
Missing env vars	Check all services are configured (see /accounts-setup)

Next Steps

• Accounts Setup - Detailed setup for all services
• Architecture - Understand the system
• Guides - Learn best practices
• Packages - Explore packages

You’re ready! Start building. 🚀