env-config-2: Node.js Package to Handle Environment Variables and Config

The goals of this package are:

• To adhere to the Twelve Factor App principle of allowing config to be specified via environment variables so that we can have complete control over it for each environment that we may need (development, staging, production etc.)
• To support setting config variables with environment variables so that we can avoid having sensitive information such as passwords in the source code
• To be able to have convenient non-sensitve config defaults in the source code for the development environment to avoid the developer having to set a bunch of environment variables just to run the application in dev.
• To support a .env file that is not under version control where developers can conveniently override config settings on a case-by-case basis in development

Installation

With npm:

npm install env-config-2 --save

With yarn:

yarn add env-config-2

Example Usage in an API Node.js App

1# File: config.js
2const envConfig = require('env-config-2')
3
4const {NODE_ENV} = process.env
5const defaultConfig ={
6  NODE_ENV,
7  PORT: (NODE_ENV === 'development' ? 3000 : null),
8  MONGODB_URL: `mongodb://localhost:27017/node_env_config_example_${NODE_ENV}`,
9  JWT_SECRET: (NODE_ENV === 'development' ? 'foobar' : null),
10  JWT_EXPIRY: (3600 * 24 * 30),
11  RATE_LIMIT: (NODE_ENV === 'production' ? 5 : null),
12  ALGOLIASEARCH_APPLICATION_ID: null,
13  ALGOLIASEARCH_API_KEY: null,
14  ALGOLIASEARCH_API_KEY_SEARCH: null,
15  API_BASE_URL: (NODE_ENV === 'development' ? 'http://localhost:3000/v1' : 'https://api.versioned.io/v1')
16}
17
18module.exports = envConfig.generateConfig(defaultConfig)

1# File: index.js
2const http = require('http')
3const config = require('config')
4
5function handler (request, response) {
6   response.writeHead(200, {'Content-Type': 'text/plain'})
7   response.end('Hello World')
8}
9
10const server = http.createServer(handler).listen(config.PORT)
11console.log('Server started with config:', config)

Resources

• The Twelve Factor App - Config
• dotenv package
• config package
• env-config package