contentful-config v0.6.0

contentful-config

Fetching JSON from Contentful to use the same configs across multiple projects and repositories.

Installation

Install using npm as devDependency.

$ npm install contentful-config --save-dev

Add a command to the scripts of package.json.

  "scripts": {
    "serve": "npm run config"
    "config": "contentful-config"
  },

Configuration

.env

Environment variables are automatically loaded by creating .env in the same directory as package.json. You can also use an existing environment variable without using .env.

CONTENTFUL_SPACE_ID=up61khjnndzm
CONTENTFUL_ACCESS_TOKEN=FeBoFnhmElUGRC76v-2T6DxOHhhhhg9FyiwWVxVs148
CONTENTFUL_CONFIG_ENV=local

You can also apply parameters when command execution without creating .env.

.cntconfigrc.json

Create a file as .cntconfigrc.json as in the following code:

{
  "local": {
    "dir": "./configs",
    "models": [
      {
        "name": "env",
        "options": {
          "order": "fields.type",
          "fields.type": "local"
        },
        "specificField": "json",
        "firstOnly": true,
        "filterUseFields": [
          "contentful.endpoint"
        ]
      },
      {
        "name": "resources",
        "options": {
          "order": "fields.type"
        }
      }
    ]
  },
  "dev": {
    "dir": "./configs",
    "models": [
      {
        "name": "env",
        "options": {
          "order": "fields.type",
          "fields.type": "dev"
        },
        "specificField": "json",
        "firstOnly": true
      }
    ]
  }
}

.gitignore

Add the destination directory of the config file to .gitignore.

configs/

Usage

Execute the following command in the same directory as the configuration file.

Execute with environment variables

$ npm run config

Execute without environment variables

$ npm run config -- dev --spaceId up61khjnndzm --accessToken FeBoFnhmElUGRC76v-2T6DxOHhhhhg9FyiwWVxVs148

Development Status

See tasks on Github Projects

Tests

1. Create a model and data for Contentful with reference to /tests/.cntconfigrc.json.
2. Create .env file insted of your Contentful's space id and access token in /tests/.
3. Run following command in / npm install && npm run test

License

MIT