Environment Variables

All environment variables are validated at build time using @t3-oss/env-nextjs. Never use process.env directly — import from @/lib/env instead.

Setup

cp .env.example .env.local

Required Variables

Variable	Description
`NEXT_PUBLIC_APP_URL`	Your app URL (`http://localhost:3000` for dev)
`NEXT_PUBLIC_APP_NAME`	App display name
`DATABASE_URL`	PostgreSQL connection string
`NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY`	Clerk publishable key
`CLERK_SECRET_KEY`	Clerk secret key
`CLERK_WEBHOOK_SIGNING_SECRET`	Clerk webhook signing secret
`STRIPE_SECRET_KEY`	Stripe secret key
`STRIPE_WEBHOOK_SECRET`	Stripe webhook signing secret
`NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY`	Stripe publishable key
`STRIPE_PRO_MONTHLY_PRICE_ID`	Stripe Price ID for Pro monthly
`STRIPE_PRO_ANNUAL_PRICE_ID`	Stripe Price ID for Pro annual
`STRIPE_BUSINESS_MONTHLY_PRICE_ID`	Stripe Price ID for Business monthly
`STRIPE_BUSINESS_ANNUAL_PRICE_ID`	Stripe Price ID for Business annual
`RESEND_API_KEY`	Resend API key
`EMAIL_FROM`	Sender email address

Optional Variables

Variable	Description
`NEXT_PUBLIC_SENTRY_DSN`	Sentry DSN for error tracking
`SENTRY_AUTH_TOKEN`	Sentry auth token for source maps

Usage in Code

// ✅ Correct — validated and typed
import { env } from "@/lib/env"
const url = env.NEXT_PUBLIC_APP_URL

// ❌ Wrong — bypasses validation
const url = process.env.NEXT_PUBLIC_APP_URL