Registry / devops / snowpack-plugin-rollup-bundle

snowpack-plugin-rollup-bundle

library0.4.4jsnpmunverified

snowpack-plugin-rollup-bundle is a Snowpack plugin designed to integrate Rollup for production bundling of web applications. The package, currently at version 0.4.4, provides functionality to process specified entrypoints (relative to the Snowpack `build/` directory), bundling them along with their corresponding CSS files and generating a `manifest.json` for hashed asset locations. It was initially developed with a focus on seamless integration with Rails applications, particularly through the `Snowpacker` gem. While it fulfills its purpose for Snowpack projects, it's important to note that Snowpack itself has largely been unmaintained since 2021, with its creators now recommending alternatives like Vite for new development. Consequently, this plugin is primarily relevant for maintaining or optimizing existing Snowpack-based projects rather than serving new build tooling initiatives.

devops

npm install snowpack-plugin-rollup-bundle

github ↗package ↗

INSTALL

IMPORT

SIG · SNOWPACK-PLUGIN-RO

snowpack-plugin-rollup-bundle

devopsjavascriptv0.4.4

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

snowpack-plugin-rollup-bundle

✓ // snowpack.config.js module.exports = { plugins: [ ['snowpack-plugin-rollup-bundle', { /* options */ }] ] };

✗ import { snowpackPluginRollupBundle } from 'snowpack-plugin-rollup-bundle';

This plugin is configured by adding its name and options directly to the `plugins` array in your `snowpack.config.js`. Snowpack config files typically use CommonJS modules.

awesomeRollupPlugin

✓ const awesomeRollupPlugin = require('awesome-rollup-plugin');

When using `extendConfig` to add custom Rollup plugins, you typically `require` them within your `snowpack.config.js` file, which is a CommonJS context.

SnowpackConfig

✓ const plugins = [ // ... ["snowpack-plugin-rollup-bundle", { /* options */ }] ]; module.exports = { plugins: plugins };

The entire `snowpack.config.js` file is usually a CommonJS module exporting the configuration object.

This quickstart shows a typical `snowpack.config.js` setup for `snowpack-plugin-rollup-bundle`, demonstrating how to enable HTML file rewriting, specify entrypoints, and extend the underlying Rollup configuration with custom plugins or options.

// snowpack.config.js const awesomeRollupPlugin = require('awesome-rollup-plugin'); // Example for extending config module.exports = { mount: { 'src': '/', }, plugins: [ // Other Snowpack plugins... [ "snowpack-plugin-rollup-bundle", { emitHtmlFiles: true, // Set to true to rewrite script tags in HTML preserveSourceFiles: false, entrypoints: [ "build/_dist_/index.js", "build/_dist_/entrypoints/*.js", ], // Required: glob patterns or array of paths relative to build/ extendConfig: (config) => { // Example: Add a custom Rollup plugin config.inputOptions.plugins.push(awesomeRollupPlugin()); // Example: Override output options config.outputOptions = { ...config.outputOptions, chunkFileNames: 'chunks/[name]-[hash].js', assetFileNames: 'assets/[name]-[hash][extname]' }; return config; } } ] ], build: { out: 'dist', metaDir: '_snowpack_', }, optimize: { bundle: false, // Ensure Snowpack's built-in bundler is off if using this plugin }, };

Debug

Known issues

breakingThe plugin option `emitHtml` was renamed to `emitHtmlFiles` in `v0.3.3`. Older configurations using `emitHtml` will no longer function correctly.

fix

Update your Snowpack configuration to use `emitHtmlFiles: true` instead of `emitHtml: true`.

affects: >=0.3.3

gotchaThe `entrypoints` option is required and expects paths relative to your Snowpack `build/` directory (e.g., `build/_dist_/index.js`), not your source `src/` directory. Providing `src/` paths will result in files not being found.

fix

Ensure all `entrypoints` paths provided in the plugin configuration correctly reference files within the `build/` output directory, typically `build/_dist_/`.

affects: >=0.1.0

gotchaBoth `rollup` and `snowpack` are peer dependencies. They must be installed separately in your project alongside `snowpack-plugin-rollup-bundle` for the plugin to function.

fix

Run `npm install --save-dev rollup snowpack` or `yarn add --dev rollup snowpack` to install the peer dependencies.

affects: >=0.3.2

gotchaSnowpack, the host tool for this plugin, is largely unmaintained by its original creators, who now recommend migration to Vite. This plugin is primarily for existing Snowpack projects and is unlikely to receive significant new features or extensive support.

fix

For new projects, consider modern build tools like Vite. For existing projects, be aware of the limited ongoing support for the Snowpack ecosystem.

affects: >=0.1.0

gotchaEarly versions (prior to `v0.4.4`) had issues with path resolution on Windows operating systems due to incorrect path separators. This was fixed in `v0.4.4`.

fix

Upgrade to `v0.4.4` or later to ensure proper functionality on Windows.

affects: <0.4.4

Errors

Common errors & fixes

Error: Cannot find module 'rollup'

The 'rollup' package, a peer dependency, has not been installed in your project.

fix

Install Rollup: `npm install --save-dev rollup` or `yarn add --dev rollup`.

Error: [snowpack-plugin-rollup-bundle] Entrypoint 'src/index.js' not found. Entrypoints must refer to the build/ directory.

The `entrypoints` option specifies a path from the source directory (`src/`) instead of the Snowpack build output directory (`build/_dist_/`).

fix

Adjust the `entrypoints` in your `snowpack.config.js` to point to the built files, e.g., `"build/_dist_/index.js"`.

TypeError: Cannot read properties of undefined (reading 'push') when extending Rollup config

Attempting to push to `config.inputOptions.plugins` or `config.outputOptions.plugins` when the `plugins` array does not exist or is undefined in the default config.

fix

Initialize the `plugins` array if it doesn't exist before pushing to it: `config.inputOptions.plugins = config.inputOptions.plugins || []; config.inputOptions.plugins.push(yourPlugin());`

Upgrade

Version history

0.4.4latest on npm

Audit

Dependencies

rolluprequiredRollup is the core bundler that snowpack-plugin-rollup-bundle integrates to perform production bundling. It is a peer dependency.

snowpackrequiredSnowpack is the host build tool for which this plugin provides extended functionality. It is a peer dependency.

Agent activity

5 hits · last 30 days

node

Resources

githubhttps://github.com/ParamagicDev/snowpack-plugin-rollup-bundle ↗

packagehttps://www.npmjs.com/package/snowpack-plugin-rollup-bundle ↗