How to use MongoDB

According to

"MongoDB is a general purpose, document-based, distributed database built for modern application developers and for the cloud era."

You can use any database with Nullstack, but the JavaScript integration and flexibility of MongoDB looks especially good with Nullstack applications.

Install the MongoDB driver from npm:

npm install mongodb

Configure the database credentials using secrets in your .env file.


The last step is to simply assign the database connection to the server context.

// server.js
import Nullstack from 'nullstack';
import Application from './src/Application';
import { MongoClient } from 'mongodb';

const context = Nullstack.start(Application);

context.start = async function() {
  const { secrets } = context;
  const databaseClient = new MongoClient(secrets.mongodbUri);
  await databaseClient.connect();
  context.database = await databaseClient.db(secrets.databaseName);

export default context;

The example above will make the database key available to all your server functions.

import Nullstack from 'nullstack';

class BooksList extends Nullstack {

  books = [];

  static async getBooks({database}) {
    return await database.collection('books').find().toArray();

  async initiate() {
    this.books = await this.getBooks();

  // ...


export default BooksList;