Prisma MongoDB Starter

The Prisma MongoDB Starter is a database foundation provided by servercn for projects that use MongoDB with Prisma ORM.

Prisma Official Docs

Installation Guide

npx servercn-cli init prisma-mongodb-starter

What This Starter Solves

Setting up Prisma with MongoDB repeatedly involves:

Database connection setup
Prisma client initialization
Schema definition
Environment configuration
Query logging and debugging

Environment Configuration

Database credentials are loaded via environment variables.

NODE_ENV='development'
PORT='9000'
LOG_LEVEL='info'
 
DATABASE_URL='mongodb+srv://<username>:<password>@<cluster>.mongodb.net/<dbname>'

The server fails fast if required database variables are missing.

Defining Schemas

Schemas are defined in using Prisma's declarative schema language.

prisma/schema.prisma

datasource db {
  provider = "mongodb"
  url      = env("DATABASE_URL")
}
 
generator client {
  provider = "prisma-client-js"
}
 
model User {
  id       String @id @default(auto()) @map("_id") @db.ObjectId
  name     String
  email    String @unique
  password String
}

Schemas are:

Explicit
Version‑controlled
Fully typed across queries

Database Client Setup

src/configs/prisma.ts

import { PrismaClient } from "@prisma/client";
import env from "./env";
 
const prisma = new PrismaClient({
  log: env.NODE_ENV === "development" ? ["query", "warn", "error"] : ["error"]
});
 
export default prisma;

No repositories or hidden layers — you interact directly with Prisma Client.

Push your schema to MongoDB

MongoDB doesn't support migrations like relational databases. Instead, use db push to sync your schema:

npm run db:push

Prisma Studio

Browse and inspect your MongoDB data visually in the browser.

npm run db:studio

Recommended Extensions

For the best experience working with Prisma schemas, install the official Prisma extension for VS Code.

.vscode/extensions.json

{
  "recommendations": [
    "Prisma.prisma"
  ]
}

The extension provides:

Syntax highlighting for .prisma files
Auto-formatting on save
IntelliSense and field autocomplete
Jump to definition for models and enums

VS Code will automatically prompt anyone who clones the project to install it.