Features > Database

Learn how to set up and configure MongoDB with Mongoose in your Nexset application. This guide covers both development and production database setup.

MongoDB Atlas Setup

• 1

  Create a new project on MongoDB Atlas

• 2

  Deploy a new cluster (free tier is sufficient for development)

• 3

  Configure network access:

• 4

  - Go to [Network Access]

• 5

  - Click [+ Add IP Address]

• 6

  - Enter 0.0.0.0/0 to allow connections from any IP

• 7

  - This enables access from both your local machine and production servers

Local Development Setup

• 1

  Install MongoDB locally for faster development

• 2

  Copy .env.example to .env.local

• 3

  Add your MongoDB connection string to MONGODB_URI in .env.local

• 4

  Format: mongodb+srv://:@.mongodb.net/?retryWrites=true&w=majority

Mongoose Integration

Nexset uses Mongoose to enhance MongoDB functionality with additional features and better type safety:

• 1

  Models are defined in the /models directory

• 2

  Each model automatically includes the toJSON plugin

• 3

  The plugin removes _id and __v fields from responses

• 4

  Use private: true on fields to exclude them from responses

Model Example

import mongoose from 'mongoose';

const userSchema = new mongoose.Schema({
  email: {
    type: String,
    required: true,
    private: true, // This field won't be sent to the frontend
  },
  name: String,
  role: {
    type: String,
    enum: ['user', 'admin'],
    default: 'user',
  },
});

const User = mongoose.models.User || mongoose.model('User', userSchema);

export default User;

Best Practices

• 1

  Use TypeScript interfaces for model types

• 2

  Implement proper validation in schemas

• 3

  Keep sensitive data private using the private option

• 4

  Use indexes for frequently queried fields

• 5

  Implement proper error handling for database operations

Environment Variables

Required environment variables for database configuration:

• 1

  MONGODB_URI: Your MongoDB connection string

• 2

  MONGODB_DB: Database name (optional)

• 3

  MONGODB_COLLECTION: Collection name (optional)