app-conf

app-conf

Usage

The following files are looked up and merged (the latest take precedence):

1. vendor: config.* in the application directory;
2. global: /etc/my-application/config.*;
3. user: ~/.config/my-application/config.*;
4. local: /.my-application.* down to ./.my-application.* in the current working directory;

Note: the local config is relative to the current working directory and only makes sense for CLIs.

var loadConfig = require("app-conf").load;

loadConfig("my-application", {
  // this is the directory where the vendor conf is stored
  appDir: __dirname,

  // default config values
  defaults: {},

  // which types of config should be loaded
  entries: ["vendor", "global", "user", "local"],

  // whether to ignore unknown file formats instead of throwing
  ignoreUnknownFormats: false,
}).then(function(config) {
  console.log(config);
});

Relative paths, string values starting by ./ or ../, are automatically resolved from the config file directory.

Paths relative to the home directory, string values starting by ~/, are also automatically resolved.

JSON format is supported natively but you may install the following packages to have additional features:

• @iarna/toml: to support TOML files;
• ini: to support INI files;
• js-yaml: to support YAML files;
• json5: to support advanced JSON files;
• strip-json-comments: to support comments in JSON files.

Contributing

Contributions are very welcome, either on the documentation or on the code.

You may:

• report any issue you've encountered;
• fork and create a pull request.

License

ISC © Julien Fontanet