webup

library2.0.0jsnpmunverified

Webup is a minimalist builder/bundler for web projects, primarily concerned with reading, joining, and splitting HTML, CSS, and JavaScript files. Unlike opinionated, all-in-one bundlers, Webup's core is intentionally 'lazy,' relying heavily on a robust plugin and preset system to perform actual bundling, optimization, and transformation tasks. The current stable version is 1.8.0, published in 2021. The project has an open-ended release cadence, with the last update several years ago. Its key differentiator is its modular approach, requiring users to explicitly configure or choose presets and plugins to achieve a desired build process, offering high flexibility but requiring more setup than integrated solutions. It supports entry points, shell templates, destination paths, and source inclusion.

devops

npm install webup

github ↗package ↗

INSTALL

IMPORT

SIG · WEBUP

webup

devopsjavascriptv2.0.0

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.

webup

✓ import webup from 'webup';

✗ import { webup } from 'webup'; const webup = require('webup');

The primary function is likely a default export, common in older bundler patterns. CommonJS `require` might work in Node, but ESM `import` is preferred for modern projects.

Demonstrates a basic Webup build configuration, bundling HTML, CSS, and JavaScript into a specified destination using the default preset.

import webup from 'webup'; // Ensure you have webup-preset-default installed: npm install webup-preset-default // and potentially create your source files: // public/index.html // public/my-app.html // public/js/main.js webup({ entry: 'public/index.html', shell: 'public/my-app.html', dest: 'build/index.html', sources: ['public/**/*', './node_modules/**/*', '!./node_modules/**/*.test.js'], // Include node_modules for dependencies plugins: [], // Custom plugins can be added here presets: ['default'] // The 'default' preset (from webup-preset-default) is essential }) .then(() => { console.log('Webup build successful!'); }) .catch(error => { console.error('Webup build failed:', error); });

webup --version

Debug

Known issues

gotchaWebup's core is deliberately minimalist and 'does nothing' by default. You must explicitly define `presets` in your configuration to enable any build functionality.

fix

Always include `presets: ['default']` (after installing `webup-preset-default`) or your custom presets in the `webup` configuration object.

affects: >=1.0.0

breakingThe project appears to be unmaintained. The last commit on GitHub was in April 2021, and the last npm publish was 3 years ago. This means there will be no future updates, bug fixes, or security patches.

fix

Consider migrating to a more actively maintained bundler (e.g., Vite, Rollup, Webpack) for new projects or for existing projects requiring ongoing support and security updates.

affects: >=1.8.0

Errors

Common errors & fixes

Error: No presets defined. Webup cannot perform any build tasks.

The `presets` array was omitted or empty in the Webup configuration.

fix

Ensure your `webup` configuration includes at least `presets: ['default']` after installing `webup-preset-default`.

SyntaxError: Cannot use import statement outside a module

Attempting to use ES module `import` syntax in a CommonJS environment without proper transpilation or Node.js configuration.

fix

Ensure your Node.js project is configured for ES modules (e.g., `"type": "module"` in `package.json`) or use `require()` syntax if strictly operating in CommonJS.

Upgrade

Version history

2.0.0latest on npm

Audit

Dependencies

webup-preset-defaultrequiredRequired for any default build behavior, as webup does nothing without presets.

webup-plugin-splitoptionalExample plugin for handling split HTML, CSS, and JS paths, often used in complex projects.

Agent activity

6 hits · last 30 days

node

Resources

githubhttps://github.com/VandeurenGlenn/webup ↗

packagehttps://www.npmjs.com/package/webup ↗