@snowpack/plugin-webpack

Use Webpack to bundle your Snowpack project for production when you run snowpack build.

See our build pipeline docs for more information.

Install

npm install --save-dev @snowpack/plugin-webpack

Then add @snowpack/plugin-webpack to snowpack.config.mjs:

export default {
  plugins: [
    [
      '@snowpack/plugin-webpack',
      {
        /* see "Plugin Options" below */
      },
    ],
  ],
};

Once added to the configuration, @snowpack/plugin-webpack will run automatically on snowpack build.

Plugin Options

• sourceMap: boolean - Enable sourcemaps in the bundled output.
• outputPattern: {css: string, js: string, assets: string} - Set the URL for your final bundled files. This is where they will be written to disk in the build/ directory. See Webpack's output.filename documentation for examples of valid values.
• extendConfig: (config: WebpackConfig) => WebpackConfig - extend your webpack config, see below.
• manifest: boolean | string - Enable generating a manifest file. The default value is false, the default file name is ./asset-manifest.json if setting manifest to true. The relative path is resolved from the output directory.
• htmlMinifierOptions: boolean | object - See below.
• failOnWarnings: boolean - Does fail the build when Webpack emits warnings. The default value is false.

Extending The Default Webpack Config

The extendConfig option is a function that you can provide to configure the default webpack config. If you provide this function, the plugin will pass its return value to webpack.compile(). Use this to make changes, add plugins, configure loaders, etc.

// snowpack.config.mjs
export default {
  plugins: [
    [
      '@snowpack/plugin-webpack',
      {
        extendConfig: (config) => {
          config.plugins.push(/* ... */);
          return config;
        },
      },
    ],
  ],
};

Minify HTML

With htmlMinifierOptions you can either disable the minification entirely or provide your own options.

// snowpack.config.mjs
export default {
  plugins: [
    [
      '@snowpack/plugin-webpack',
      {
        htmlMinifierOptions: false, // disabled entirely,
      },
    ],
  ],
};

The default options are:

{
  collapseWhitespace: true,
  removeComments: true,
  removeEmptyAttributes: true,
  removeRedundantAttributes: true,
  removeScriptTypeAttributes: true,
  removeStyleLinkTypeAttributes: true,
}