Repository navigation
Releases
Fluid v3.3 — Material Studio
Fluid v3.3 expands the open-source studio into a procedural material instrument. Choose the field, add pigment or shading, then choose the surface underneath it.
- 30 engines: new wash, spray, brushwork, strata, terrazzo, and woodgrain.
- 12 finishes: watercolor, graffiti, charcoal, pastel, ink, and ceramic join glass, metal, sand, liquid, molten, and oil paint.
- 6 independent surfaces: canvas, paper, concrete, stone, wood, and plaster.
- 16 artist recipes, with finish strength, texture size, relief, and surface strength controls.
- Full support in share links, PNG/JPG/WebP and standalone HTML export, fluid-core, fluid-bg, REST, and MCP. Existing links remain compatible.
- Backgrounds page with ten ambient presets, blur/dim controls, and four templates.
- Self-hosted embed bundle and build-drift checks; production deploys only after tests pass.
The live-site update is pending production approval in PR #5. To try v3.3 now, download the source at this tag and open index.html, then select MONSOON, BACK ALLEY, OIL STUDY, or CELADON in Look.
Install the v3.3 engine
These GitHub archives contain the current version; npm registry publication is separate.
npm install https://github.com/enonforetsam/fluid/releases/download/v3.3.0/fluid-core-3.3.0.tgz
npm install https://github.com/enonforetsam/fluid/releases/download/v3.3.0/fluid-bg-3.3.0.tgzAfter the live-site update, the matching site script will be:
<script src="https://befluid.xyz/fluid-bg.js"></script>
<fluid-bg preset="mist" blur="24"></fluid-bg>Documentation: Material guide · Verification
Validated with 164 automated tests, 75 GPU checks on Apple M4/Chromium, mobile viewport/touch checks, saved-setting restoration, 2048×2048 PNG export, offline standalone HTML, and browser rendering from the installable package. Physical phones and Safari were not tested.
MIT licensed. The existing v4.0.0 tag is retained; v3.3.0 identifies this material-engine release. Hosted publishing/community work remains separate.
v0.3.0 — math lenses, three layers, Topo
The source that produced fluid-core@0.3.0 and fluid-bg@0.3.0 on npm.
Tagged at e49854f rather than at the tip: every file in the published fluid-core tarball is byte-identical to that commit, and it is the first commit for which that holds. master has since moved on with studio work that does not change the packages.
What landed
- Math lenses in the libraries. Twelve conformal transforms of the plane — square, invert, Möbius, Droste, hyperbolic, Julia, cube, exp, sine, Joukowski, Newton, modular — were studio-only. They are now reachable from
fluid-coreandfluid-bg. - Three layers. Stack three engines, each with its own blend mode and mix.
- Topo, the 23rd engine: elevation contours of a drifting landmass, warp sets ruggedness.
Fixed
- The 23rd engine was unreachable through the libraries. A hardcoded clamp bounded the engine index at 21, so Topo silently rendered as Cassini in every CDN embed. The bound is now derived from the engine list, and pinned by a test so the next engine cannot reintroduce it.
Install
npm i fluid-core@0.3.0
npm i fluid-bg@0.3.0
Or without a build step — see the dev page.