Bundle Selection
hyperfixi ships multiple pre-built bundles so you can match bundle size to your project's needs. The figures below are measured from the installed @hyperfixi/core@2.9.3 build (raw and gzipped).
Bundle Comparison
| Bundle | Size (raw / gzip) | Commands | Best for |
|---|---|---|---|
hyperfixi-lite.js |
5 KB / 1.9 KB gz | 8 | Minimal interactivity: toggle, show, hide, add, remove, set, put |
hyperfixi-lite-plus.js |
8 KB / 2.6 KB gz | 14 | Basic interactivity with wait, log, increment, trigger, go |
hyperfixi-hybrid-complete.js Recommended |
30 KB / 7.7 KB gz | 21 | Recommended for most apps - 85% hyperscript coverage |
hyperfixi-hx.js |
68 KB / 18.1 KB gz | 21 | htmx/fixi drop-in replacement with hx-get, hx-post, hx-target |
hyperfixi.js |
1470 KB / 312.2 KB gz | 58 | Complete bundle with all commands and features |
Choosing a Bundle
Lite (5 KB)
Best for simple interactivity — toggling classes, adding/removing elements, basic event handling. If your hyperscript stays under 8 commands, this is all you need.
Included commands: add, remove, toggle, put, set, take, log, wait
<script src="https://unpkg.com/@hyperfixi/core/dist/hyperfixi-lite.js"></script>
Lite Plus (8 KB)
Adds convenience aliases and a few more commands for slightly richer interactions.
<script src="https://unpkg.com/@hyperfixi/core/dist/hyperfixi-lite-plus.js"></script>
Hybrid Complete (30 KB)
The recommended bundle for most projects. Includes control flow (if/else, repeat, for), fetch, and block expressions.
<script src="https://unpkg.com/@hyperfixi/core/dist/hyperfixi-hybrid-complete.js"></script>
Hybrid HX (68 KB)
Everything in Hybrid Complete plus htmx-like attribute compatibility (hx-get, hx-post, etc.) and fixi attribute support. Use this if you're replacing or pairing with htmx.
<script src="https://unpkg.com/@hyperfixi/core/dist/hyperfixi-hx.js"></script>
Browser Full (1470 KB)
All 58 commands plus the full parser. Use this for development, prototyping, or when you need every feature. In production, prefer the Vite plugin for automatic tree-shaking.
<script src="https://unpkg.com/@hyperfixi/core/dist/hyperfixi.js"></script>
Tree-Shaking with Vite
Instead of choosing a fixed bundle, the Vite plugin scans your source files and generates a minimal bundle containing only the commands you actually use. This is the recommended approach for production builds.
npm install @hyperfixi/core @hyperfixi/vite-plugin
See the Vite Plugin guide for setup instructions.
Next Steps
- Vite Plugin — Automatic tree-shaking for production
- Installation — All installation options
- Cookbook — Practical examples