@fairfox/standalone-web

Standalone Preact + HTM + Signals

A single, standalone version of Preact, HTM and Preact Signals. No external dependencies, just one single file.

Latest versions included:

• Preact: 10.27.0
• @preact/signals: 2.2.1
• HTM: 3.1.1

Available as a single file for CDN usage or local vendoring.

Usage

Via esm.sh CDN (Recommended)

<div id="app"></div>
<script type="module">
  import {
    html,
    render,
    signal,
    Fragment
  } from "https://esm.sh/@fairfox/standalone-web@1.0.4";

  const count = signal(0);

  function App() {
    return html`
      <Fragment>
        <h1>Hello World!</h1>
        <button onClick=${() => (count.value += 1)}>
          Increment with signal
        </button>
        <p>Counter: ${count}</p>
      </Fragment>
    `;
  }

  render(html`<${App} />`, document.getElementById("app"));
</script>

TypeScript Support

When using TypeScript with esm.sh, type definitions are automatically provided:

import { html, render, signal, useSignal } from "https://esm.sh/@fairfox/standalone-web@1.0.4";

const count = signal<number>(0);

function Counter() {
  const localCount = useSignal(0);
  
  return html`
    <div>
      <p>Global: ${count}</p>
      <p>Local: ${localCount}</p>
      <button onClick=${() => localCount.value++}>+</button>
    </div>
  `;
}

React Compatibility Version

For use with React component libraries:

<script type="module">
  import {
    html,
    render,
    signal,
    Fragment,
    memo,
    forwardRef
  } from "https://esm.sh/@fairfox/standalone-web@1.0.4/dist/standalone-web-react-compat.js";

  // Now compatible with React ecosystem libraries
</script>

Via npm (not recommended)

I don't recommend installing this package via NPM. It's best to install Preact, HTM and Preact Signals separately:

npm install preact htm @preact/signals
# or yarn
yarn add preact htm @preact/signals
# or pnpm
pnpm install preact htm @preact/signals

Motivation and goals

You can absolutely use separate packages via CDN (and it works fine):

<script type="module">
  import { h, render } from "https://esm.sh/preact";
  import htm from "https://esm.sh/htm";
  import { signal } from "https://esm.sh/@preact/signals";
  const html = htm.bind(h);
</script>

or use the combined HTM/Preact export:

<script type="module">
  import { html, render } from "https://esm.sh/htm/preact";
  import { signal } from "https://esm.sh/@preact/signals";
</script>

However, there are some situations where having either a single import is more convenient, or where one wants to vendor an already optimised build of these core components (eg for a browser extension).

Simply put, the ideal situation is:

<script type="module">
  // Use via esm.sh CDN with automatic TypeScript support
  import { html, render, signal } from "https://esm.sh/@fairfox/standalone-web@1.0.4";
  
  // OR download locally for offline use
  import { html, render, signal } from "./standalone-web.js";
</script>

All rights belong to Preact, HTM and Preact Signals owners/maintainers.

Building from source

Install and bundle using Bun:

git clone https://github.com/alexjeffcott/standalone-web.git
cd standalone
bun install
bun run bundle        # Creates dist files

Files Generated

• dist/index.js - main bundle (23.8 KB minified)
• dist/compat.js - React compatibility version (30.5 KB minified)
• dist/index.d.ts - TypeScript definitions
• dist/index.d.ts.map - maps for TypeScript definitions
• dist/compat.d.ts - TypeScript definitions for compat version
• dist/compat.d.ts.map - maps for TypeScript definitions for compat version