Bundle Selection
hyperfixi ships multiple pre-built bundles so you can match bundle size to your project's needs. All sizes are uncompressed — with gzip, expect roughly 30-40% of listed sizes.
Bundle Comparison
| Bundle | Size | Commands | Best For |
|---|---|---|---|
hyperfixi-lite.js |
5 KB | 8 | Minimal interactions (toggle, add, remove) |
hyperfixi-lite-plus.js |
8 KB | 14 | More commands + aliases |
hyperfixi-hybrid-complete.js |
28 KB | 21 + blocks | Most projects (if/else, repeat, fetch) |
hyperfixi-hybrid-hx.js |
39 KB | 21 + htmx/fixi | htmx & fixi attribute compatibility |
hyperfixi-browser.js |
280 KB | 43 | Full features + parser |
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 (28 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 (39 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-hybrid-hx.js"></script>
Browser Full (280 KB)
All 43 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-browser.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