Neutrino Copy Middleware

@neutrinojs/copy is Neutrino middleware for copying files during building.

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/copy can be installed via the Yarn or npm clients.


❯ yarn add @neutrinojs/copy


npm install --save @neutrinojs/copy


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

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

// Use with default options

// Usage shows the default values of this middleware:
neutrino.use(copy, {
  patterns: [],
  options: {},
  pluginId: 'copy'
// Using object or array middleware format

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

// Usage shows the default values of this middleware:
module.exports = {
  use: [
    ['@neutrinojs/copy', {
      patterns: [],
      options: {},
      pluginId: 'copy'

The patterns and options are defined from the CopyWebpackPlugin. See their docs for details on valid values to specify.

  • patterns: An array of patterns specifying copy operations.
  • options: An object specifying copy options.
  • pluginId: The plugin identifier. Override this to add an additional copy plugin instance.


@neutrinojs/copy 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
copy Copy files during building. 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 ""