Feature Library

Split-flap board

Not measured yet
A still of the Split-flap board demo
Still
The live demo starts when it’s in view.

A three-piece GPU flap drum for text, countdown digits and pictures quantised to colour shades.

Staggered starts, falling reverse faces, reusable instance buffers and final-text DOM announcements, with immediate reduced-motion changes and WebGL2 fallback.

What it costs a frame

Not measured yet.

What it needs

Renders with
WebGPU or WebGLWebGPU where there is one, WebGL2 where there is not.
Your browser
Runs hereNo WebGPU needed
Depends on
three.js r187No other packages
With an agent
install("split-flap-board")Your coding agent reads its pitfalls and installs it through the library’s MCP server. Set it up

What it’s for

  1. A departures board in an event foyer
  2. A countdown to an opening
  3. An animated typographic title
  4. A low-resolution picture on colour flaps

Pitfalls, in brief

  1. Rows (1–32), columns (1–64), drum and picture shades are construction-time choices; maximum 2048 cells.
  2. Call update(dtSeconds) from your own loop. flipSpeed is 2–40 flaps per second, stagger is 0–0.1 seconds per column.
  3. An update arriving mid-transition replaces the single pending target.
  4. showCountdown accepts remaining seconds (0–5999), rounded up, displayed as mm:ss.
  5. showPicture accepts RGBA pixel data of at most one megapixel and a required description.
4 more in brief
  1. Pass an accessibilityHost in the DOM and keep the module stylesheet.
  2. The group is centred at the origin, faces +Z and uses Y up, with column pitch 1 and row pitch 1.5.
  3. Three instanced flap draws plus one housing, using TSL vertex attributes on WebGPU and the WebGL2 backend.
  4. Dispose removes the group and accessible DOM and frees owned geometry, materials and textures.
9 pitfalls in full, the hook-up guide, the module source and its tests come with the part.

Where it comes from

From another of the maker’s apps. Fully custom code.

split flapdeparturescountdownpicturelettersdruminstancingTSLreduced motionscreen reader

Near it in the frame