Every application or server usually needs to configure libraries and tools, for example a database driver to make queries.

Nodepack will automatically lookup for a config folder at the root of your project.

For example, you can create a db.js file:

// config/db.js

export default {
  driver: 'pg',
  host: 'localhost',
  user: 'user',
  password: 'password',
  database: 'my_app',

This will create a db configuration for your project.

Then you can use it in your code like this:

import db from '@config/db'

Plugins will also take advantage of this system, so they can lookup for configuration in this config folder. For example, database migrations will automatically try to connect to the database with the db configuration.

Usage in context

You can retrieve a configuration in the context with context.config.someConfig. If for example we want our db config:


Usage in plugins

Use the @nodepack/app-config package to retrieve the user app configurations:

// Will retrieve the `db` configuration
import { db } from '@nodepack/app-config'

if (db) {
  // ...

Usage outside of app

You can directly load the config built fragment of the project:

const { db } = require('my-project/dist/config')

Standard configurations

Those configuration should be recognized by relevant plugins.

  • db: main database connection information

It should return a connection info object. Example:

// config/db.js
export default {
  type: 'pg',
  host: 'localhost',
  port: 5432,
  user: 'admin',
  password: '········',
  • redis: redis connection information


// config/redis.js
export default {
  host: 'localhost',
  port: 4002,
  • pubsub: realtime events implementation

It should return an object of the following interface:

class PubSubEngine {
  public abstract publish(triggerName: string, payload: any): Promise<void>;
  public abstract subscribe(triggerName: string,
    onMessage: Function, options: Object): Promise<number>;
  public abstract unsubscribe(subId: number);

Example (in-memory):

// config/pubsub.js
import { PubSub } from 'graphql-subscriptions'

export default new PusSub()

Example (redis):

// config/pubsub.js
import { RedisPubSub } from 'graphql-redis-subscriptions'
import RedisConfig from './redis'

export default new RedisPubSub({
  connection: RedisConfig