{"id":15640,"library":"html-bundle","title":"HTML Bundle","description":"html-bundle is a primarily zero-config bundler designed for using HTML as Single File Components (SFCs), allowing inline `\n \n \n

Hello, HTML Bundle!

\n \n

\n \n\n\n# Terminal commands to run the project\nnpm install\nnpm run build\nnpm run dev","lang":"typescript","description":"This quickstart demonstrates how to set up `html-bundle` for both development (with HMR) and production builds, including a basic HTML Single File Component structure with inline styles and an optional client-side script using `hydro-js`."},"warnings":[{"fix":"Use a dedicated entry point for HMR-enabled development if `index.html` is complex or serves as a multi-page entry. Ensure development server is configured correctly.","message":"When using the `--hmr` flag, `html-bundle` generates a development build. This mode is best suited for local development and might not function optimally if triggered from the main `index.html` due to specific HMR injection mechanisms.","severity":"gotcha","affected_versions":">=6.0.0"},{"fix":"Generate the necessary TLS certificates using a tool like `mkcert` (e.g., `mkcert -install && mkcert localhost`) and place them in the root directory.","message":"Enabling secure HTTP2 over HTTPS with the `--secure` flag requires `localhost.pem` and `localhost-key.pem` files to be present in the project's root folder. Without these, the server will fail to start in secure mode.","severity":"gotcha","affected_versions":">=6.0.0"},{"fix":"Prioritize CLI flags for temporary or environment-specific overrides. For persistent changes, modify `bundle.config.js`. When debugging, check both CLI args and config file.","message":"Configuration options provided via CLI flags will always override equivalent settings defined in a `bundle.config.js` file. Be aware of this precedence when debugging unexpected build behaviors.","severity":"gotcha","affected_versions":">=6.0.0"},{"fix":"Add `\"jsxFactory\": \"h\"` under `compilerOptions` in your `tsconfig.json` file. Ensure `hydro-js` or a compatible JSX runtime is available.","message":"For TypeScript projects using JSX directly in `