HyperBolts Compiler

1.0.18 verified Sat Apr 25 auth: no javascript

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.

Common errors

error Cannot find module 'babel-loader' ↓

cause 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 Error: No gulpfile found ↓

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

fix

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

error gulp: command not found ↓

cause Gulp is not installed globally.

fix

npm install -g gulp

Warnings

deprecated Webpack 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.

gotcha Requires 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

breaking npm2 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

gotcha File 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).

gotcha Default 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.

Install

npm install hyperbolts-compiler

yarn add hyperbolts-compiler

pnpm add hyperbolts-compiler

Imports

default (run function)
wrong
```
import run from 'hyperbolts-compiler';
```
correct
```
require('hyperbolts-compiler').run();
```
Package does not export ESM; use CommonJS require(). The run() function is the main entry point.
run() with config object
wrong
```
const { run } = require('hyperbolts-compiler'); run({...});
```
correct
```
require('hyperbolts-compiler').run({ bundle: { src: 'src/index.jsx', dest: 'dist/bundle.js' } });
```
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
wrong
```
gulp.task('build', require('hyperbolts-compiler'));
```
correct
```
require('hyperbolts-compiler').run(); // then run 'gulp --watch'
```
Do not assign the require result to a Gulp task; the run() method sets up the task automatically.

Quickstart

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