The example catalog: 119 raylib demos in jolt

preview	bb name	shows
	camera-3d	an orbiting 3D camera, Camera3D by value
	waving-cubes	196 cubes rippling in 3D (shared rl/cube!)
	camera-3d-first-person	WASD + mouse-look walk through columns
	tesseract-view	a rotating 4D hypercube projected 4D→3D→2D
	wireframe-shapes	pyramid / torus / helix as rlgl 3D lines
	rlgl-solar-system	Sun / Earth / Moon via the rlgl matrix stack
	box-collisions	a player cube vs. boxes, 3D AABB highlight
	rotating-cube	a single cube spinning via the rlgl matrix stack
	spinning-cubes	a row of cubes each spinning with a phase offset
	orthographic-projection	perspective vs orthographic (SPACE toggles)
	point-cloud	~1500 points as tiny rlgl cubes, rotating
	bouncing-spheres	spheres bouncing in a 3D box (rl/sphere!)
	lorenz-attractor	the Lorenz attractor traced in 3D
	dna-helix	a turning double helix with coloured base pairs
	yaw-pitch-roll	the three aircraft rotations in 3D
	first-person-maze	walk a grid maze in first person, with a minimap

The 3D set stands entirely on two building blocks from rlgl-immediate-mode.md and struct-by-value-pointer-trick.md: with-camera-3d (the camera, by pointer) and cube! (the geometry, by rlgl vertices).

preview	bb name	shows
	game-of-life	Conway's Game of Life (SPACE reseeds)
	boids	flocking birds (separation/alignment/cohesion)
	fireworks	rockets + fading particle bursts
	fourier-epicycles	rotating circles trace a square wave
	spirograph	animated hypotrochoid roulette curves
	l-system	an L-system fractal plant (grows + regrows)
	flow-field	particles steered by a flow field (trails)
	cellular-automata	Wolfram's elementary automata
	clock-of-clocks	six digits spelled by a grid of clock hands

All eight are pure math + the drawing API, no new bindings. They showcase the suite as a generative-art canvas: cellular automata, agent flocking, particle systems, rotating-vector Fourier series, parametric roulette curves, string-rewrite fractals, and noise-steered flow fields.

raylib's texture API returns structs by value and has no binding here; these go through rlgl's scalar layer instead, so every texture is built pixel by pixel in native memory rather than loaded from a file. See textures-via-rlgl.md.

preview	bb name	shows
	texture-procedural	four textures built pixel by pixel
	texture-tiling	one tile repeated across the window
	render-texture	a scene drawn off-screen, then reused
	bunnymark	the sprite-count benchmark (click to add)

GLSL compiled at runtime and run over a full-screen quad. raylib's LoadShader returns a Shader by value, which needed jolt's [:by-value [:struct ...]] - so these are the first examples with a hard jolt floor (0.7.23). The source lives as a string in each namespace rather than a .glsl file, so an example stays one self-contained file.

That [:by-value ...] support also supersedes the workarounds described in textures-via-rlgl.md and struct-by-value-pointer-trick.md; those pages still describe what the suite currently does elsewhere. A page on the by-value API itself is not written yet.

preview	bb name	shows
	julia-set	the Julia set, mouse-steered, in a shader
	mandelbrot-set	the Mandelbrot set, zoomable, in a shader
	raymarching	a raymarched SDF scene in a shader
	rounded-rect-shader	SDF rounded rects: fill, border, shadow
	palette-switch	bands recolored by an ivec3 palette
	shader-hot-reload	swap and recompile the GLSL at runtime
	postprocessing	post-process shaders cycled over a scene
	custom-uniform	a mouse-steered swirl over a scene
	texture-painting	a blank texture painted by a shader
	multi-sampler	two textures blended by a second sampler

The suite is deliberately mechanical to grow. One new example touches five places:

1. Source: src/net/b12n/raylib_jlt/<name>.clj, a namespace with a -main that runs the canonical loop (see headless-smoke-testing.md) against the net.b12n.raylib-jlt.raylib API.
2. deps.edn alias: :<name> {:main-opts ["-m" "net.b12n.raylib-jlt.<name>"]} so jolt -M:<name> works.
3. check.clj require: add net.b12n.raylib-jlt.<name> to the :require list in net.b12n.raylib-jlt.check, so the headless compile-check covers it.
4. Registry row: add ["<display-name>" "<alias>" "<group>" "<desc>"] to the examples vector in scripts/examples_registry.clj, the single source of truth that bb.edn and the demo recorder both read.
5. bb.edn task: add a matching <name> {:doc "..." :task (run-example "<name>")} row, so bb <name> works alongside bb info / bb examples / bb run-all.

bb check:registration verifies all five without needing jolt or libraylib, and CI runs it before the compile gate. Touchpoint 3 is why it exists: bb check compiles what check.clj requires, so an example missing from that list is never compiled and the run still reports success.

Note that the alias is not always the display name, and the namespace is derivable from neither. ["basic-window" "run" ...] reaches net.b12n.raylib-jlt.core through the :run alias, and twelve rows differ this way, so deps.edn is the source of truth for which namespace a row means.

A new group needs two more edits: the group list in bb.edn's info task and the :groups vector in scripts/demo_manifest.edn.

flowchart LR
  src["src/…/<name>.clj<br/>the example"] --> deps["deps.edn<br/>:<name> alias"]
  src --> chk["check.clj<br/>require (headless compile)"]
  src --> reg["scripts/examples_registry.clj<br/>registry row"]
  reg --> bb["bb.edn<br/>bb &lt;name&gt; task"]

Filenames use underscores (basic_screen_manager.clj); the namespace uses hyphens (net.b12n.raylib-jlt.basic-screen-manager), Clojure's standard file↔ns mapping.

One ordering rule applies inside every file: since jolt 0.4.0 an unresolved symbol is a compile error rather than a late-bound reference, so a definition must appear before its first use, in a fn body and in an :or destructuring default just as much as at top level. It bites hardest in the shared raylib.clj binding layer, where one misordered symbol stops every example from loading and only the first offender is reported. jolt -M:check is the quick confirmation; see the jolt note in the README.

• kwarg-drawing-api.md: the API every example is written against.
• headless-smoke-testing.md: the loop shape and how bb run-all / bb check verify the catalog.