# stage1 > High-performance JavaScript micro framework Latest version **0.10.0** (published 2025-08-15) · MIT license · 0 weekly downloads ## Install ```sh npm install stage1 pnpm add stage1 yarn add stage1 bun add stage1 ``` ## Health **Score 60/100 (C)** — status: stable. Positive: has types; esm support; no vulnerabilities; has provenance; high maintenance score; high quality score. Warnings: low downloads; pre 1.0. Negative: stale. ## Facts | | | |---|---| | Version | 0.10.0 | | Published | 2025-08-15 | | First published | 2021-05-03 | | Weekly downloads | 0 | | License | MIT | | TypeScript types | bundled | | Module format | ESM + CommonJS | | Dependencies | 0 | | Unpacked size | 125.3 KB | | Known vulnerabilities | 0 | | Install scripts | no | | Provenance | attested (GitHub Actions) | | GitHub stars | 4 | | Author | Max Milton | | Maintainers | maxmilton | ## Links - npm: https://www.npmjs.com/package/stage1 - Repository: https://github.com/maxmilton/stage1 - Homepage: https://github.com/maxmilton/stage1#readme - Issues: https://github.com/maxmilton/stage1/issues - npm.io page: https://npm.io/package/stage1 ## Recent versions - 0.10.0 (latest) — 2025-08-15 - 0.11.0-next.0 (next) — 2026-09-24 - 0.9.0 — 2025-06-24 - 0.8.0-next.19 — 2025-05-24 - 0.8.0-next.18 — 2025-05-24 - 0.8.0-next.17 — 2025-04-17 - 0.8.0-next.16 — 2024-12-14 - 0.8.0-next.15 — 2024-12-01 - 0.8.0-next.14 — 2024-11-29 - 0.8.0-next.13 — 2024-07-13 - 0.8.0-next.12 — 2024-07-01 - 0.8.0-next.11 — 2024-07-01 - 0.8.0-next.10 — 2024-06-24 - 0.8.0-next.9 — 2024-06-24 - 0.8.0-next.8 — 2024-01-22 - … 34 more at https://npm.io/package/stage1/versions ## README [![CI status](https://badgen.net/github/checks/maxmilton/stage1?label=ci)](https://github.com/maxmilton/stage1/actions) [![Coverage %](https://badgen.net/codeclimate/coverage/maxmilton/stage1)](https://codeclimate.com/github/maxmilton/stage1) [![NPM version](https://badgen.net/npm/v/stage1)](https://www.npmjs.com/package/stage1) [![Licence](https://badgen.net/github/license/maxmilton/stage1)](./LICENSE) [![Minified size](https://badgen.net/bundlephobia/minzip/stage1)](https://bundlephobia.com/package/stage1) ![Dependency count](https://badgen.net/bundlephobia/dependency-count/stage1) # stage1 High-performance JavaScript micro framework. > Warning: This is alpha software. Test thoroughly before using in production. Please report any bugs you find! Originally a fork of the excellent project. ## TODO - Decide whether to keep multiple implementations - Browser "live" compile, browser runtime mode - Bun default precompiled mode - Bun "fast" precompiled mode (use this as the default implementation and remove "normal" precompiled mode?) - Downside is the API is different to the other modes (`collect` function return type) - Keep only the most used functionality in `stage1` and move less used but still useful functionality to `stage2` - Should the reactive store be in `stage1` or `stage2`? - Should less used DOM utilities be moved to `stage2`? - `prepend` - `insert` - `replace` - `text`? - How much focus should be given to `stage1` used as a prebuilt/CDN browser/live package vs a build-time library? - Maybe we can actually include more functionality when used as a lib but intentionally reduce what's included in the prebuilt browser/live package. - Add documentation about: - Security: - Internal use of `innerHTML` — potential risk of XSS etc.; never use `h` and `html` functions with untrusted input - In future we may have `Sanitizer.sanitizeFor(...)` which could be used to sanitize untrusted input - It's unlikely we'll use it internally due to performance overhead but developers should definitely sanitize input when untrusted before passing it in... although we could create light wrapper functions - - - New DOM utility functions - `fragment` - `text` - `create` - `clone` - `append` - `prepend` - `insert` - `replace` - `onRemove` - New reactive store feature - Differences from the original `stage0` project: - There are now 3 runtime modes: - New precompiled runtime mode and a fast variant for ultimate performance. Compiles templates at build-time via a bun macro that minifies templates, generates metadata, and then includes minimal runtime code in your JS bundle. Currently only works with [Bun.build](https://bun.sh/docs/bundler). - The fast mode is a variant of the precompiled mode that uses a different API and is further optimized for performance. - The regular mode is still available which generates metadata when your JS is run in the browser. Regular mode can be used with or without a build process. - Ref nodes are now marked with `@` rather than `#` - `h` is now `function h(template: string): S1Node` e.g., `h('

@key

')` - `html` is available to use as a string template literal tag function e.g., `` html`

@key

` `` (regular mode only) - `view.collect` is now a `collect` function that needs to be imported separately - Extra DOM utils - New reactive `store` factory can be imported from `stage1/store` - Improved TypeScript support - Reduced size and improved load and runtime performance - Import paths: - Other than reconcilers and the store, everything is a named export from `stage1` - Reconcilers all export a `reconcile` function - `/keyed` --> `/reconcile/keyed` - `/reconcile` --> `/reconcile/non-keyed` - `/reuse-nodes` --> `/reconcile/reuse-nodes` - Ref names must be lowercase because some browsers normalize element attribute names when rendering HTML - Note: No longer the case in "fast" mode (different API). - Comments may be used as refs - Add API and usage documentation - The regular mode `h()` function does not support skipping minification in whitespace sensitive HTML blocks like `

` and `` because it would be too slow. The precompiled mode `compile()` macro does however. Same for the other compile options.
- Add more tests
- Add examples
- Set up benchmarking + compare to `stage0` and other JS frameworks
- Submit to 

## Browser support

> Note: Internet Explorer is not supported.

Minimum browser version required:



- Chrome 26
- Edge 13
- Firefox 22
- Safari 8
- Opera 15

If using the browser runtime mode or synthetic click events:



- Chrome 38
- Edge 13
- Firefox 36
- Safari 9
- Opera 25

Some optional features require a higher browser version:

- `html` tagged template literal function uses `String.raw`; [requirements](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/raw#browser_compatibility)
- `onRemove` utility function uses `for...of` and `MutationObserver`; [requirements](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/for...of#browser_compatibility), [requirements](https://developer.mozilla.org/en-US/docs/Web/API/MutationObserver/)
  - NOTE: Moved to `stage2` package
- `store` uses `Proxy`; [requirements](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Proxy/Proxy#browser_compatibility)
  - Also uses [logical nullish assignment](<(https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Logical_nullish_assignment#browser_compatibility)>) and [optional chaining operator](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Optional_chaining#browser_compatibility), however, build tools can transform these for old browser targets

SSR (server-side rendering) is not supported and is not the intended use of this library.

## Build environment JS runtime support

The default precompiled mode runtime requires [bun](https://bun.sh/) version 1.0.20 or above.

The regular mode browser bundle does not have any specific build requirements.

## Bugs

Please report any bugs you encounter on the [GitHub issue tracker](https://github.com/maxmilton/stage1/issues).

## Changelog

See [releases on GitHub](https://github.com/maxmilton/stage1/releases).

## License

MIT license. See [LICENSE](https://github.com/maxmilton/stage1/blob/master/LICENSE).

---

© 2025 [Max Milton](https://maxmilton.com)

---
_Source: https://npm.io/package/stage1 · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._