BuildSmiths StarterKit

Subscription‑ready SaaS starter: Next.js 15 (App Router) · Postgres · Auth.js (credentials) · optional Stripe · Tailwind v4 · Vitest · JSON logs + audit hooks. Minimal by design. Start with billing disabled, enable Stripe when ready. Postgres is required.

Quickstart (5 minutes)

Clone & install

git clone https://github.com/buildsmiths/buildsmiths-nextjs-postgres-stripe.git
cd buildsmiths-nextjs-postgres-stripe
npm install
cp .env.example .env.local

Fill required env in .env.local
- NEXT_PUBLIC_SITE_URL (http://localhost:3000 for local)
- DATABASE_URL (Postgres connection string)
- NEXTAUTH_SECRET (strong random string)
Apply database schema (idempotent)
```
npm run db:schema
```
Run the app
```
npm run dev  # http://localhost:3000
```
Run tests
```
npm test
```