Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 400,000 packages pre-installed, including flconf with all npm packages installed. Try it out:

var flconf = require("flconf")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

flconf v2.2.0

Simple, pluggable, hierarchical configs


Build Status

Simple, pluggable, hierarchical configs


$ npm install flconf --save


If you have a config directory that looks like:

├── default.json
└── env
    ├── development.json
    ├── production.json
    └── test.json
var config = require('flconf')(__dirname + '/config');

config.use('env/' + process.env.NODE_ENV || 'development');

module.exports = config.load();

flconf will load default.json first, then it will load the config file for the appropriate NODE_ENV. You can specify as many layers of config as you like.

Config filenames can be globs as matched by minimatch.


var Config = require('flconf');


Creates a new Config instance. You must provide the dirname that flconf will use while loading config files.

You can omit the new operator and simply invoke flconf with the dirname if you wish:

var config = require('flconf')(__dirname);


Adds file as a layer in this config. file should be the path to a config file without the .json extension.


Adds a plugin to this config's plugin stack. Plugins are simply JSON.parse reviver functions that modify the config in some way. See the plugins section for more details.


Loads all of the specified config files and returns the merged config object.



Replaces any bash-style environment variables with their actual values in the environment.

  "user": "${LOGNAME}"

Will load as:

  "user": "ruppel"


Replaces ms-style time strings with their value in milliseconds.

  "maxAge": "1 day"

Will load as:

  "maxAge": 86400000


This software is free to use under the MIT license. See the LICENSE file for license text and copyright information.


RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free