Neverending Perpetual Motion

    TypeScript icon, indicating that this package has built-in type declarations

    0.7.13 • Public • Published


    Configuration management for fullstack-one packages and applications.


    A configuration module is a configuration registered with @fullstack-one/config singleton, e.g. by other @fullstack-one packages.

    An application is the main program, that utilizes the @fullstack-one framework.

    The main idea is, that each package registers a configuration module with a set of properties it requires to run. The values of those properties depend on multiple configuration sources, that are merged in a fixed hierarchy. The following shows the merging hierarchy with the primary configuration on top and the most subsidiary configuration at the bottom:

    process.env configuration
    application environment configuration
    application default configuration
    module environment configuration
    module default configuration

    Hint: If any value is still null after the merge, @fullstack-one/config will throw an error.


    Setup for @fullstack-one packages

    First add the config package as a dependency to your package:

    npm install --save @fullstack-one/config

    Load the config singleton using the @fullstack-one/di package and register your configuration via the path of your config directory as a configuration module, e.g.:

    import { Config } from "@fullstack-one/config";
    class MyFullstackOnePackage {
      private myConfig: Config;
      constructor(@Inject((type) => Config) config) {
        this.myConfig = config.registerConfig("MyConfig", `${__dirname}/../config`);

    @fullstack-one/config goes into the specified directory and tries to find the default.js. Additionally, the environment config, e.g. development.js, is loaded based on process.env.NODE_ENV. The default configuration is mandatory (if not given an error is thrown) and the environment configuration is optional. The configuration directory may look like this:

    $ cd config && find .

    The configuration files only describe the configuration module and may look like this:

    module.exports = {
      'a': true,
      'b': {
        'c': null,
        'd': 'foo'

    Setup in the Application

    As soon as any @fullstack-one package is loaded and initialized, that uses @fullstack-one/config, the application is required to have a ./package.json and a ./config directory on the same level as its main file (given by require.main.filename). If one of these is not given, @fullstack-one/config throws an error.

    Analogously to the packages, the application has to have a default.js and may have environment configuration files. The application's configuration files do not describe only one configuration module, but all in one object, e.g.:

    module.exports = {
      'MyFullstackOnePackage': {
        'a': true,
        'b': {
          'c': null,
          'd': 'foo'
      'Package2': { ... },

    Hint: It does not have to include all properties, as the objects will be merged.

    Setup the process environment

    On registration of a configuration module the process environment is loaded via process.env. The name of the variable is interpreted as path in the whole configuration object. For example, the following process environment variable would lead to the respective change in the config object:

    export MyFullstackOnePackage.b.c=changed
      "MyFullstackOnePackage": {
        "a": true,
          "b": {
            "c": "changed",
            "d": "foo"
      "Package2": { ... },


    You can use registerConfig(moduleName, configDirPath), registerApplicationConfigModule(moduleName, configObject) and getConfig(moduleName) as described above. Find examples in ./test.


    You can also get the whole config object containing all config modules using dangerouslyGetWholeConfig(). If you are in the middle of a boot process for example, some config modules might have not been set.




    npm i @fullstack-one/config

    DownloadsWeekly Downloads






    Unpacked Size

    29.9 kB

    Total Files


    Last publish


    • eterehov
    • dustin-h
    • bettervest_david