Mongoose Starter

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

Mongoose Official Docs

Installation Guide

npx servercn-cli init mongoose-starter

What This Starter Solves

Setting up Mongoose with MongoDB repeatedly involves:

Database connection reliability
Schema & Model organization
Validation logic
Environment‑based credentials
TypeScript integration

The Mongoose Starter standardizes these concerns using a structured, explicit setup.

What You Get Out of the Box

After initialization, your project includes:

Database Core

Mongoose configured for MongoDB
Typed Schema definitions
Centralized database connection logic

Configuration

Environment‑based database config
Connection event handling (success, error)
Production‑ready settings

Developer Experience

Type inference from schemas
Clean model separation
Ready-to-use patterns

Environment Configuration

Database credentials are loaded via environment variables.

NODE_ENV='development'
PORT='9000'
LOG_LEVEL='info'
 
DATABASE_URL=mongodb://localhost:27017/db-name

The server fails fast if required database variables are missing.

Defining Schemas

Schemas are written using Mongoose's Schema API with TypeScript support.

src/models/user.model.ts

import mongoose, { Document, Model, Schema } from "mongoose";
 
export interface IUser extends Document {
  _id: mongoose.Types.ObjectId;
  name: string;
  email: string;
  password: string;
  role: "user" | "admin";
  isEmailVerified: boolean;
 
  createdAt: Date;
  updatedAt: Date;
}
 
const userSchema = new Schema<IUser>(
  {
    name: {
      type: String,
      required: [true, "Name is required"],
      trim: true
    },
    email: {
      type: String,
      required: [true, "Email is required"],
      unique: true,
      lowercase: true,
      trim: true
    },
    password: {
      type: String,
      select: false,
      default: null
    },
    role: {
      type: String,
      enum: ["user", "admin"],
      default: "user"
    },
    isEmailVerified: {
      type: Boolean,
      default: false
    }
  },
  {
    timestamps: true
  }
);
 
const User: Model<IUser> = mongoose.model<IUser>("User", userSchema);
export default User;

Schemas are:

Typings enabled
Validation-rich
Easy to extend

Database Client Setup

src/configs/db.ts

import mongoose from "mongoose";
import env from "./env";
import { logger } from "../utils/logger";
 
export const connectDB = async (): Promise<void> => {
  try {
    const conn = await mongoose.connect(env.DATABASE_URL as string);
    logger.info(`✅ MongoDB Connected: ${conn.connection.host}`);
  } catch (error) {
    logger.error(error, "❌ MongoDB Connection Failed:");
    process.exit(1);
  }
};

This setup ensures a robust connection handling strategy, exiting the process on failure to prevent undefined behaviors.

Summary

The Mongoose Starter gives you a clean, production‑ready database foundation using MongoDB + Mongoose.

It prioritizes developer experience, schema validation, and rapid iteration — providing a reliable data layer for your Node.js applications.