A library to interactively create and read configuration files.
Last updated 7 months ago by zvr .
AGPL-3.0 · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install africa 
SYNC missed versions from official npm registry.


npm version Build status Pipeline Badge


africa is a Node.JS package which simplifies reading from and writing to persistent configuration files in user's home directory. If a configuration exists, it will be read, and if not, the user will be presented with questions, after which the answers will be stored in the .rc file.

yarn add africa

Table Of Contents


The package is available by importing its default function:

import africa from 'africa'

async africa(
  packageName: string,
  questions=: !_reloquent.Questions,
  config=: !Config,
): !Object

Read package configuration from the home directory, or ask questions with readline interface to create a new configuration in ~/.${packageName}rc.

  • <kbd>packageName*</kbd> string: The name of the package.
  • <kbd>questions</kbd> !_reloquent.Questions (optional): An object with questions to ask when config wasn't found.
  • <kbd>config</kbd> !Config (optional): Configuration object.

Call africa asynchronously to read or create a new configuration. Questions should adhere to the reloquent's interface.

Config: The configuration object to configure additional functionality.

Name Type Description Default
force boolean Ask questions and update the configuration file even if it already exists. false
homedir string In which directory to save and search for configuration file. os.homedir()
questionsTimeout number How log to wait in ms before timing out. Will wait forever by default. -
local boolean Whether to read a local config file in the current working directory rather than in the HOMEDIR. When initialising, the default values will be taken from the home config if it exists so that it is easy to extend .rc files. false
recursive boolean paid Read all configurations up to the root one from the home directory, and merge them together. false
skipExisting boolean paid When creating nested configs, skip writing values that are taken from parent RCs. true
rcNameFunction (packageName: string) => string Function used to generate the .rc name. Default: packageName => .${packageName}rc. -
import africa from 'africa'
import { userInfo } from 'os'

(async () => {
  try {
    const config = await africa('africa', {
      name: {
        defaultValue: userInfo().username,
        text: 'user',
    }, { force: true })
  } catch ({ stack }) {
user: [zavr]
{ name: 'zavr' }


It's possible to ask questions in groups, such that answers will be received in a nested object. Only 1 level of nesting is supported at the moment. To group questions, import the Group type and pass questions to it.

import africa, { Group } from 'africa'

africa('test', {
  group: new Group({
    test: {
      text: 'hello',
  nongroup: {
    text: 'your-name',
}, { force: true, homedir: __dirname })
your-name: [name-doc] name-doc
hello: [world-doc] world-doc
  "nongroup": "name-doc",
  "group": {
    "test": "world-doc"

Copyright & License

Photo Diana Robinson, 2017

GNU Affero General Public License v3.0

Art Deco © Art Deco™ 2020 AGPL-3.0

Current Tags

  • 1.5.0                                ...           latest (7 months ago)

10 Versions

  • 1.5.0                                ...           7 months ago
  • 1.4.0                                ...           7 months ago
  • 1.3.1                                ...           a year ago
  • 1.3.0                                ...           a year ago
  • 1.2.0                                ...           2 years ago
  • 1.1.2                                ...           2 years ago
  • 1.1.1                                ...           2 years ago
  • 1.1.0                                ...           2 years ago
  • 1.0.1                                ...           3 years ago
  • 1.0.0                                ...           3 years ago
Maintainers (1)
Today 1
This Week 1
This Month 2
Last Day 0
Last Week 1
Last Month 1
Dependencies (0)
Dev Dependencies (16)
Dependents (2)

Copyright 2014 - 2016 © |