🚀 Quick NestJS Prisma v7 Starter

A blazing-fast starter for NestJS 11 + Prisma 7 + PostgreSQL + Swagger with JWT authentication and TODO CRUD

Stop wrestling with setups and boilerplate. Start building real features in minutes.

⚡ One Command Setup

bunx quick-nest my-app
# or
npx quick-nest my-app

Your backend is ready in seconds.

package: bunx quick-nest

Pre Configured

• 🏗️ NestJS 11 — Modern & scalable Node.js
• 🗄️ Prisma ORM v7 — Type-safe DB access
• 🐘 PostgreSQL — Production-grade database
• 🔐 JWT Auth — Secure login & register
• 📚 Swagger — Interactive API docs
• 📦 Zero Config — Ready to run instantly
• ⚡ Bun Support — Fast development
• ☁️ Cloud Ready — Deploy anywhere

📦 Tech Stack

| Technology | Version | |------------|---------| | NestJS | 11.x | | Prisma ORM | 7.x | | PostgreSQL | 15+ | | TypeScript | 6.x | | Bun | 1.2+ | | Swagger | - | | JWT | 11.x | | Passport | 0.7+ | | bcrypt | 6.x |

⚡ Quick Start

1. Create Project

npm create quick-nest my-app
cd my-app

2. Configure Environment

cp .env.example .env

Update .env:

DATABASE_URL="postgresql://user:password@localhost:5432/quick_nest"
JWT_SECRET="your-super-secret-key"

3. Run Database Migrations

bunx prisma migrate dev --name init

This will:

• Create database schema
• Generate Prisma Client
• Set up initial tables (User, Todo)

4. Start Server

bun run start:dev

API runs at: http://localhost:3000

📚 API Documentation (Swagger)

Interactive API Docs

Once your server is running, visit:

http://localhost:3000/api/docs

Swagger UI is pre-configured and ready to use. No additional setup needed!

🗄️ Prisma & Database

Useful Commands

# Generate Prisma client
bunx prisma generate

# Create migration
bunx prisma migrate dev --name feature_name

# Open database GUI
bunx prisma studio

# Reset database (dev only)
bunx prisma migrate reset

📁 Project Structure

src/
├── common/
│   ├── decorators/
│   └── guards/
├── core/
│   └── prisma/
├── modules/
│   ├── auth/
│   │   ├── auth.controller.ts
│   │   ├── auth.service.ts
│   │   ├── auth.module.ts
│   │   ├── strategies/
│   │   └── dto/
│   └── todo/
│       ├── todo.controller.ts
│       ├── todo.service.ts
│       ├── todo.module.ts
│       └── dto/
├── app.module.ts
└── main.ts

prisma/
├── schema.prisma
└── migrations/

🔐 Authentication

• User registration with validation
• JWT-based login system
• Password hashing with bcrypt
• Protected routes via guards
• Refresh token support (optional)

📝 Todo Module

• ✅ Create todo
• ✅ Read todos (list & single)
• ✅ Update todo
• ✅ Delete todo
• ✅ User-specific data isolation

📡 API Endpoints

| Method | Route | Description | |--------|-------|-------------| | POST | /auth/register | Create user | | POST | /auth/login | Login user | | GET | /todos | Get all todos | | GET | /todos/:id | Get single todo | | POST | /todos | Create todo | | PATCH | /todos/:id | Update todo | | DELETE | /todos/:id | Delete todo |

☁️ Deployment

Works great with:

• Vercel — Serverless Node.js
• Railway — Modern cloud platform
• Render — Easy Node.js hosting
• Fly.io — Distributed deployment
• Docker — Container-based deployment
• VPS — Self-hosted options

📋 Requirements

| Tool | Version | |------|---------| | Node.js | 22+ | | Bun | 1.2+ | | PostgreSQL | 15+ |

🎯 Setup toolkit

Everything is intentionally minimal so you can understand and extend it with confidence.

🧱 Extensible by Design

Easily add:

• Redis caching
• Rate limiting
• Background jobs (Bull, RabbitMQ)
• Email service (Nodemailer, SendGrid)
• File uploads (AWS S3, Cloudinary)
• WebSockets (Socket.io)
• OAuth login (Google, GitHub)
• RBAC authorization
• Logging & monitoring (Winston, Sentry)
• Testing (Jest, e2e tests)
• GraphQL support

🚀 Next Steps

• Explore Examples — Review /src/modules for patterns
• Add Features — Extend with your business logic
• Deploy — Deploy in vercel (recomend)

📄 License

MIT — Feel free to use for any project.

💡 Tips

• Use bunx prisma studio to visualize your database
• Keep secrets in .env, never commit them
• Follow the feature-based folder structure for scalability
• Test your API with Postman/Swagger
• Use bun run start:debug for debugging

Made with ❤️ for developers who want to build fast.

Happy coding! 🎉