Registry / devops / hyperbolts-compiler

hyperbolts-compiler

library1.0.18jsnpmunverified

An opinionated JavaScript bundler and asset compiler for React projects, with built-in support for hot loading, local webserver, BrowserSync, ES6 transpilation (Babel), SASS compilation, and image minification. Uses Webpack 2 under the hood. Current stable version: 1.0.18. Release cadence appears sporadic, with last release likely older. Key differentiators: all-in-one setup with sensible defaults, integrated hot reloading and sync testing, requires Gulp as a peer dependency. Alternatives: Webpack, Parcel, Vite. Note: This project appears less actively maintained.

devops web-framework http-networking

npm install hyperbolts-compiler

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · HYPERBOLTS-COMPILE

hyperbolts-compiler

devopsjavascriptv1.0.18

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.

default (run function)

✓ require('hyperbolts-compiler').run();

✗ import run from 'hyperbolts-compiler';

Package does not export ESM; use CommonJS require(). The run() function is the main entry point.

run() with config object

✓ require('hyperbolts-compiler').run({ bundle: { src: 'src/index.jsx', dest: 'dist/bundle.js' } });

✗ const { run } = require('hyperbolts-compiler'); run({...});

Destructuring require works, but the object spread or named export is not needed. The package exports a single object with a run method.

Gulp task

✓ require('hyperbolts-compiler').run(); // then run 'gulp --watch'

✗ gulp.task('build', require('hyperbolts-compiler'));

Do not assign the require result to a Gulp task; the run() method sets up the task automatically.

Install dependencies, create minimal React app with entry point, HTML template, and gulpfile, then run with watch.

npm install -g gulp npm install --save gulp hyperbolts-compiler react react-dom mkdir -p src assets/public cat > src/index.jsx << 'EOF' import React from 'react'; import ReactDOM from 'react-dom'; ReactDOM.render(<h1>Hello, world!</h1>, document.getElementById('__react_mount')); EOF cat > assets/public/index.html << 'EOF' <!DOCTYPE html> <html><body><div id="__react_mount" /><script src="bundle.js"></script></body></html> EOF cat > gulpfile.js << 'EOF' require('hyperbolts-compiler').run(); EOF gulp --watch

hyperbolts --version

Debug

Known issues

deprecatedWebpack 2 is outdated; many loaders and plugins have breaking changes in newer Webpack versions.

fix

Consider migrating to a newer bundler like Webpack 5 or Vite.

affects: >=0.0.18

gotchaRequires Gulp 3.x or 4.x globally and locally. Gulp 4 has breaking changes in task syntax.

fix

Ensure Gulp is installed: npm install -g gulp && npm install --save-dev gulp

affects: >=0.0.0

breakingnpm2 users must install additional peer dependencies manually due to flat dependency resolution issues.

fix

Run: npm install --save babel-loader babel-preset-latest babel-preset-react react-hot-loader webpack-dev-middleware webpack-hot-middleware webpack-module-hot-accept

affects: >=0.0.0

gotchaFile changes may not be picked up on some systems due to Webpack watching issues.

fix

Refer to Webpack documentation for watching troubleshooting (fsnotify limitations, polling).

affects: >=0.0.0

gotchaDefault mount point expects element with id '__react_mount' - not a standard React root convention.

fix

Use <div id="__react_mount"></div> in your HTML, or override via custom config.

affects: >=0.0.0

Errors

Common errors & fixes

Cannot find module 'babel-loader'

npm2 does not install peer dependencies automatically.

fix

npm install --save babel-loader babel-preset-latest babel-preset-react react-hot-loader webpack-dev-middleware webpack-hot-middleware webpack-module-hot-accept

Error: No gulpfile found

The project lacks a gulpfile.js that calls require('hyperbolts-compiler').run().

fix

Create a gulpfile.js with the content: require('hyperbolts-compiler').run();

gulp: command not found

Gulp is not installed globally.

fix

npm install -g gulp

Upgrade

Version history

1.0.18latest on npm

Audit

Dependencies

gulprequiredHyperBolts Compiler is a Gulp plugin; users must install Gulp globally and locally.

Agent activity

8 hits · last 30 days

node

Resources

githubhttps://github.com/hyperbolts/compiler ↗

packagehttps://www.npmjs.com/package/hyperbolts-compiler ↗

homepagehttps://hyperbolts.io ↗