On this page

Generators

Registry discovery, schemas, and the current tool set.

Generators are the units of design. Each has a slug, param schema, defaults, and one or more render paths.

Discovery

curl -s http://localhost:3001/v1/generators

Response items look like:

{
  "slug": "marble-vein",
  "name": "Marble Vein",
  "version": "0.1.0",
  "formats": ["png", "webp"],
  "animated": false,
  "defaults": { "scale": 3.2, "warp": 1.4 },
  "paramSchema": { "type": "object", "properties": {} }
}

Agents and UIs should treat this endpoint as the live catalog, not a hardcoded list.

Current set

Organic fields and abstract tools (category Abstract in the UI):

Slug	Name
`shader-gradient`	Shader Gradient
`mesh-gradient`	Mesh Field
`marble-vein`	Marble Vein
`aurora-curtain`	Aurora Curtain
`nebula-bloom`	Nebula Bloom
`film-iridescence`	Film Iridescence
`caustic-pool`	Caustic Pool
`starfield`	Starfield
`liquid-chrome`	Liquid Chrome
`silk-flow`	Silk Flow
`contour-atlas`	Contour Atlas
`magnetic-ink`	Magnetic Ink
`prism-cascade`	Prism Cascade
`plasma-vortex`	Plasma Vortex
`frost-crystal`	Frost Crystal
`light-trails`	Light Trails
`waveform`	Waveform
`blob-sculpt`	Blob Sculpt
`radial-burst`	Radial Burst
`voronoi-facet`	Voronoi Facet
`stripe-field`	Stripe Field
`dot-lattice`	Dot Lattice
`chevron-flow`	Chevron Flow
`geo-tile`	Geo Tile
`grain-noise`	Grain Field

Open any of the 25 tools in the tools library.

Material studies

The new material tools use different rendering techniques and include four authored presets each:

Tool	Visual controls	Export
Liquid Chrome	Liquid folds, relief, polish and studio light direction	PNG, WebP, GIF, MP4
Silk Flow	Fabric pleats, billow, sheen and fine threads	PNG, WebP, GIF, MP4
Contour Atlas	Elevation bands, terrain warp, contour weight and paper	PNG, WebP
Magnetic Ink	Labyrinth density, ink coverage and reflected edges	PNG, WebP
Prism Cascade	Glass blades, refraction, dispersion and brilliance	PNG, WebP, GIF, MP4
Plasma Vortex	Spiral arms, central aperture, inclination and emission	PNG, WebP, GIF, MP4
Frost Crystal	Seeded crystal growth, side branches and frosted glass	PNG, WebP
Light Trails	Filament bundles, sweep, opening and glow	PNG, WebP, GIF, MP4

Mesh Field v0.2 adds local color falloff, warped boundaries and contour definition. Caustic Pool v0.2 replaces soft patches with focused light networks and supports seamless animated exports. Their existing slugs, presets and recipe links still work, with the revised rendering appearance. New optional parameters receive defaults when opening older recipes.

Animated material tools use speed for motion amplitude and loopSeconds for duration. A speed of zero freezes the image. PNG/WebP use the same still phase shown in the editor.

Mesh Field's SVG samples the color field into vector paths; its CSS export is a lightweight radial-gradient approximation. Choose PNG or WebP for the full rendered detail.

Param schemas

Schemas are Zod on the engine, exported as JSON Schema on the API. The web editor builds controls from the same shapes (grouped in the UI by presentation metadata).

Invalid params → 400 with RFC 9457 problem details.

Adding a generator (engine)

Implement under packages/engine/src/generators/<slug>/
registerGenerator(...) in generators/index.ts
Optional: catalog blurb in apps/web/src/lib/catalog.ts
Tests in multi-gen.test.ts (double-render + seed variance)