Neutrino Environment Middleware

@neutrinojs/env is Neutrino middleware for injecting environment variable definitions into source code at process.env. You can use this to make a custom environment variable (e.g. an API server backend to use) available inside your project. Always injects process.env.NODE_ENV, unless overridden.

NPM version NPM downloads Join the Neutrino community on Spectrum


  • Node.js v6 LTS, v8, v9
  • Yarn v1.2.1+, or npm v5.4+
  • Neutrino v8


@neutrinojs/env can be installed via the Yarn or npm clients.


❯ yarn add @neutrinojs/env


npm install --save @neutrinojs/env


@neutrinojs/env can be consumed from the Neutrino API, middleware, or presets. Require this package and plug it into Neutrino:

// Using function middleware format
const env = require('@neutrinojs/env');

// Use with default options

// Usage with additional environment variables
neutrino.use(env, ['SECRET_KEY']);
// Using object or array middleware format

// Use with default options
module.exports = {
  use: ['@neutrinojs/env']

// Usage with additional environment variables
module.exports = {
  use: [
    ['@neutrinojs/env', ['SECRET_KEY']]

This middleware optionally accepts an array of environment variables to additionally inject into source code.


@neutrinojs/env creates some conventions to make overriding the configuration easier once you are ready to make changes.


The following is a list of plugins and their identifiers which can be overridden:

Name Description Environments and Commands
env Inject environment variables into source code at process.env. all


This middleware is part of the neutrino-dev repository, a monorepo containing all resources for developing Neutrino and its core presets and middleware. Follow the contributing guide for details.

results matching ""

    No results matching ""