create-pern-scaffold

Scaffold a production-ready, type-safe full-stack app in seconds. Powered by PostgreSQL, Express, React, Node.js, and TypeScript throughout.

npx create-pern-scaffold

What you get

A monorepo with a client/ and server/ package, pre-wired and ready to run:

• Frontend — React + Vite + TypeScript, TanStack Query, React Router, Axios
• Backend — Express v5 + TypeScript, structured routes/controllers/services
• Database — PostgreSQL with your choice of ORM
• Testing — Vitest + Supertest (server), Vitest + React Testing Library (client)
• Tooling — ESLint + Prettier (optional), Docker Compose (optional), Git init (optional)

Options

During setup you'll be prompted to choose:

| Option | Choices | |---|---| | ORM | Prisma, Drizzle, Sequelize | | Auth | None, JWT, Session | | Database setup | Skip, Docker Compose, Connection string | | Code quality | ESLint + Prettier | | Docker Compose | Yes / No | | Git init | Yes / No |

Getting started

npx create-pern-scaffold
cd my-app

# Start the backend
cd server && bun run dev

# Start the frontend (new terminal)
cd client && bun run dev

Frontend runs on http://localhost:5173, backend on http://localhost:8080.

Requirements

• Bun v1.0+
• Node.js v18+ (for npx)
• PostgreSQL (or Docker for local setup)