Skip to content

Neutrino Banner Middleware

@neutrinojs/banner is Neutrino middleware for injecting string content into source code files.

NPM version NPM downloads

Requirements

  • Node.js 10+
  • Yarn v1.2.1+, or npm v5.4+
  • Neutrino 9
  • webpack 4

Installation

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

Yarn

❯ yarn add --dev @neutrinojs/banner

npm

❯ npm install --save-dev @neutrinojs/banner

Usage

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

const banner = require('@neutrinojs/banner');

// Use with default options
neutrino.use(banner());

// Also accepts options for webpack's BannerPlugin
// https://webpack.js.org/plugins/banner-plugin/

// Usage shows the default values of this middleware:
neutrino.use(
  banner({
    banner: `require('source-map-support').install();`,
    test: neutrino.regexFromExtensions(),
    raw: true,
    entryOnly: true,
    // Override pluginId to add an additional banner plugin instance
    pluginId: 'banner',
  }),
);
// Using in .neutrinorc.js
const banner = require('@neutrinojs/banner');

// Use with default options
module.exports = {
  use: [banner()],
};

// Also accepts options for webpack's BannerPlugin
// https://webpack.js.org/plugins/banner-plugin/

// Usage shows the default values of this middleware:
module.exports = {
  use: [
    banner({
      banner: `require('source-map-support').install();`,
      test: neutrino.regexFromExtensions(),
      raw: true,
      entryOnly: true,
      // Override pluginId to add an additional banner plugin instance
      pluginId: 'banner',
    }),
  ],
};

Customization

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

Plugins

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

Name Description NODE_ENV
banner Injects string content into application source code. all

Contributing

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