{"id":18439,"library":"hyperbolts-compiler","title":"HyperBolts Compiler","description":"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.","status":"active","version":"1.0.18","language":"javascript","source_language":"en","source_url":"https://github.com/hyperbolts/compiler","tags":["javascript","hyperbolts","bundler","compiler","react","hot-loading","hot-loader","hot","loader"],"install":[{"cmd":"npm install hyperbolts-compiler","lang":"bash","label":"npm"},{"cmd":"yarn add hyperbolts-compiler","lang":"bash","label":"yarn"},{"cmd":"pnpm add hyperbolts-compiler","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"HyperBolts Compiler is a Gulp plugin; users must install Gulp globally and locally.","package":"gulp","optional":false}],"imports":[{"note":"Package does not export ESM; use CommonJS require(). The run() function is the main entry point.","wrong":"import run from 'hyperbolts-compiler';","symbol":"default (run function)","correct":"require('hyperbolts-compiler').run();"},{"note":"Destructuring require works, but the object spread or named export is not needed. The package exports a single object with a run method.","wrong":"const { run } = require('hyperbolts-compiler'); run({...});","symbol":"run() with config object","correct":"require('hyperbolts-compiler').run({ bundle: { src: 'src/index.jsx', dest: 'dist/bundle.js' } });"},{"note":"Do not assign the require result to a Gulp task; the run() method sets up the task automatically.","wrong":"gulp.task('build', require('hyperbolts-compiler'));","symbol":"Gulp task","correct":"require('hyperbolts-compiler').run(); // then run 'gulp --watch'"}],"quickstart":{"code":"npm install -g gulp\nnpm install --save gulp hyperbolts-compiler react react-dom\nmkdir -p src assets/public\ncat > src/index.jsx << 'EOF'\nimport React from 'react';\nimport ReactDOM from 'react-dom';\nReactDOM.render(Hello, world!
, document.getElementById('__react_mount'));\nEOF\ncat > assets/public/index.html << 'EOF'\n\n\nEOF\ncat > gulpfile.js << 'EOF'\nrequire('hyperbolts-compiler').run();\nEOF\ngulp --watch","lang":"javascript","description":"Install dependencies, create minimal React app with entry point, HTML template, and gulpfile, then run with watch."},"warnings":[{"fix":"Consider migrating to a newer bundler like Webpack 5 or Vite.","message":"Webpack 2 is outdated; many loaders and plugins have breaking changes in newer Webpack versions.","severity":"deprecated","affected_versions":">=0.0.18"},{"fix":"Ensure Gulp is installed: npm install -g gulp && npm install --save-dev gulp","message":"Requires Gulp 3.x or 4.x globally and locally. Gulp 4 has breaking changes in task syntax.","severity":"gotcha","affected_versions":">=0.0.0"},{"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","message":"npm2 users must install additional peer dependencies manually due to flat dependency resolution issues.","severity":"breaking","affected_versions":">=0.0.0"},{"fix":"Refer to Webpack documentation for watching troubleshooting (fsnotify limitations, polling).","message":"File changes may not be picked up on some systems due to Webpack watching issues.","severity":"gotcha","affected_versions":">=0.0.0"},{"fix":"Use in your HTML, or override via custom config.","message":"Default mount point expects element with id '__react_mount' - not a standard React root convention.","severity":"gotcha","affected_versions":">=0.0.0"}],"env_vars":null,"last_verified":"2026-04-25T00:00:00.000Z","next_check":"2026-07-24T00:00:00.000Z","problems":[{"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","cause":"npm2 does not install peer dependencies automatically.","error":"Cannot find module 'babel-loader'"},{"fix":"Create a gulpfile.js with the content: require('hyperbolts-compiler').run();","cause":"The project lacks a gulpfile.js that calls require('hyperbolts-compiler').run().","error":"Error: No gulpfile found"},{"fix":"npm install -g gulp","cause":"Gulp is not installed globally.","error":"gulp: command not found"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}