Installation¶

Package manager¶

npm install flux-htmx
npm install htmx.org@^4.0.0   # peer dependency for the core builds

ESM (Vite, Webpack, esbuild…)¶

import { bootstrapFlux } from 'flux-htmx';

bootstrapFlux(); // publishes window.Flux and honours <meta name="flux-config">

Importing the module has no global side effects — modular consumers opt in. bootstrapFlux() installs the runtime, applies meta-tag configuration and publishes window.Flux unless something is already there.

CommonJS¶

const Flux = require('flux-htmx').default;

A real CJS build ships as dist/flux.cjs — main points at it, so plain require('flux-htmx') works in bundlers that still consume CJS.

Optional net entry¶

Offline queue, upload progress and optimistic UI live in a separate entry so core users ship less:

import { installNet } from 'flux-htmx/net';
installNet();

CDN¶

<script src="https://cdn.jsdelivr.net/npm/flux-htmx@2/dist/flux.full.iife.js"></script>
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/flux-htmx@2/dist/flux.min.css" />

<script src="https://unpkg.com/flux-htmx@2/dist/flux.full.iife.js"></script>
<link rel="stylesheet" href="https://unpkg.com/flux-htmx@2/dist/flux.min.css" />

Bundle matrix¶

Pin a version¶

<script src="https://cdn.jsdelivr.net/npm/flux-htmx@2.1.0/dist/flux.full.iife.js"></script>

Pinning the major (@2) gets you fixes without breaking changes; pinning the exact version is safest for production.