1.0.10 β’ Published 5 months ago
bigify v1.0.10
Bigify - Simplified MongoDB Connection for Node.js
π Introduction
Bigify is a lightweight, easy-to-use package that helps developers quickly establish a MongoDB connection in their Node.js applications. With just a single function call, you can set up a secure and optimized connection to your MongoDB database.
π¦ Installation
Install Bigify via npm:
npm install bigify
Since mongoose
is a peer dependency, you must install it separately if you havenβt already:
npm install mongoose
π§ Usage
Basic Example
const mongoose = require('mongoose');
const { connectDB } = require('bigify');
connectDB( mongoose, 'mongodb://localhost:27017/mydatabase', {} );
Advanced Usage with Options
const mongoose = require('mongoose');
const { connectDB } = require('bigify');
connectDB(
mongoose,
'mongodb://localhost:27017/mydatabase',
options: {
serverSelectionTimeoutMS: 5000, // Custom timeout
}
);
π Features
- π₯ Zero Configuration β No extra setup required.
- β‘ Auto-Handles Connection Errors β Prevents app crashes due to database connection failures.
- π οΈ Custom Configuration Support β Allows passing additional MongoDB connection options.
- π Minimalistic & Efficient β Lightweight package with no unnecessary dependencies.
π οΈ API Reference
connectDB({ mongoose, database, options })
- mongoose (required): Your installed
mongoose
instance. - database (string, required): MongoDB connection string.
- options (object, optional): Additional MongoDB connection options. (NOTE : This is a Optional Parameter)
Example:
connectDB(
mongoose,
'mongodb://localhost:27017/mydatabase',
options: { // Allows users to pass extra Mongoose options if needed.
serverSelectionTimeoutMS: 5000,
useNewUrlParser: true,
useUnifiedTopology: true,
useCreateIndex: true,
useFindAndModify: false,
}
);
β FAQ
1. Why do I need to install mongoose separately?
Bigify does not include mongoose
to give you flexibility in choosing your version. If you havenβt installed it yet, run:
npm install mongoose
2. Can I pass custom connection options?
Yes! Simply provide an options
object when calling connectDB
.
3. Does this package support MongoDB Atlas?
Absolutely! Just pass the MongoDB Atlas connection string as the database
parameter.