Deterministic, PDF-like documents that evolve docstep by docstep.
Flux keeps layout locked while inline parameters and grid slots update deterministically. The packet below is a typeset view of a real Flux document — click to turn pages.
npm i -g @flux-lang/fluxflux self updateIII. Run Launcher: fluxflux self update updates the full toolchain via the launcher.
A Flux document is a living specification.Write the document once. Let it evolve.
It describes structure, content, and transformation in one place—then compiles into stable outputs you can render, export, and automate. Local-first by design: your files stay yours, and the same document can be edited interactively or scripted in CI.
- Declare: compose pages, layout, and semantics with a typed document model.
- Transform: generators + slots + docsteps turn one spec into many precise variants.
- Render: produce consistent outputs (web/print/export) from the same IR.
- Automate: scriptable tooling makes builds reproducible, diffable, and boring-in-a-good-way.
doc Packet {
slot headline refresh: docstep
layout pages = 1
render { html, pdf }
}Flux Documents
Flux documents are structured, versioned score documents backed by an AST/IR that you can author, validate, and render with confidence.
Validate + Inspect
Check a document and inspect the canonical IR snapshot to power tooling, automation, and repeatable builds.
Tooling Workflow
Install once with the launcher, update with flux self update, and work locally in the CLI + editor on the same IR.
Compiled from main.
Merged PRs summarized into release-ready highlights, refreshed directly from the Flux feed.
Flux documents are living documents.
Word meets computer algebra meets a DAW.
A .flux file is source you can parse, validate, and render.
Every document has readable source and a dependable AST/IR snapshot, so the same file powers tools, layouts, and exports.
That structure makes diffs, validation, and rendering consistent across your workflow.
Share a .flux document you’ve made.
We’ll curate a few highlights for the upcoming Examples page.