A tag is a filter now, so the vocabulary is closed

[abernier]

195 tags for 170 examples, 145 of them on a single example, 29 examples with none, and 13 whose line in llms.txt was the name alone. This closes the vocabulary at 117 tags, gives every example at least one, and makes the badges the way into a ?tag= filter.

The design was settled question by question before any of it was written; the two things that need your eyes are the list and the 31 examples that were re-read, both below.

Decisions

What tags are for	A navigable facet — and the only thematic axis on examples://index
Register	One: the technique. The API register (meshreflectormaterial, useanimations) and the subject register (arkanoid, codrops, tag-heuer) leave
How the list was built	Bottom-up: the 195 minus the evicted registers, minus the merges. No frequency threshold, so no pill ever returns nothing
Governance	Closed enum on tags in the schema, exactly what libraries gets. Unknown tag = error, not warning
Minimum	≥ 1 tag, enforced by the validator
Form	kebab-case, lower-case; the more frequent form wins a singular/plural pair, ties to the singular
Re-tag depth	Targeted: the code of the 31 that would have been left empty was read, not their titles
UI	Clickable badge only, no picker. Multi-selection, ANDed, with the dead ends disabled rather than left to be found
MCP	Nothing — the index already enumerates the tags, and the schema is published at its $id

What to review

Six terms the catalog did not carry, introduced by the re-reading: fisheye (2) · lod (2) · views (2) · debug (1) · hmr (1) · ssgi (1).

One call worth contesting: instancing → instances follows the frequency rule (5 vs 2), but instances is also drei's component name, which the API-register rule would have evicted. The rule won over the register. Say the word and it flips.

The 31 read out of their own source

example	tags
bvh	bvh raycast
canvas-text	html events
cards	scroll infinite text
cards-with-border-radius	scroll infinite shader
clouds	volumetric
csg-house	csg controls soft-shadows environment
dbismut-furniture	transitions spring gltf html
ecctrl-fisheye	fisheye physics controls game
enter-portals	portal router text gltf
flying-bananas	lod gltf dof postprocessing
gltf-animations-re-used	gltf animation clone spring
gltf-animations-tied-to-scroll	gltf animation scroll soft-shadows
ground-projected-envmaps-lamina	ground-projection environment contact-shadows material
image-gallery	reflections router text
magic-box	portal controls gltf
motionpathcontrols	controls bezier postprocessing gltf
multiple-views-with-uniform-controls	views controls state soft-shadows
pairing-threejs-to-ui	html suspense contact-shadows gltf
portals	portal gltf contact-shadows environment
rapier-ping-pong	physics game collisions audio
re-using-geometry-and-level-of-detail	lod re-use gltf environment
room-with-soft-shadows	pcss soft-shadows gltf
shader-hmr	shader material hmr
shopping	outlines postprocessing bvh mask
simple-physics-example-with-debug-bounds	physics debug
ssgi-spheres-with-rapier-physics	ssgi physics postprocessing environment
threejs-journey-lv-1-fisheye	fisheye controls environment gltf
thunder-clouds	volumetric camera-shake physics contact-shadows
trigger-meshes	physics collisions
video-cookies	video-texture gobo soft-shadows postprocessing
view-tracking	views scroll html controls

The 117, by weight

gltf 36 · physics 23 · html 19 · postprocessing 19 · scroll 15 · transmission 15 · shader 14 · controls 13 · animation 12 · bloom 10 · environment 10 · reflections 10 · soft-shadows 9 · game 8 · instances 7 · portal 7 · contact-shadows 6 · text 6 · audio 5 · material 5 · particles 5 · refraction 5 · spring 5 · annotations 4 · collisions 4 · dof 4 · outlines 4 · volumetric 4 · bvh 3 · camera-shake 3 · csg 3 · events 3 · gradient 3 · ground-projection 3 · infinite 3 · raycast 3 · router 3 · ssr 3 · state 3 · stencil 3 · transitions 3 · ambient-occlusion 2 · bezier 2 · bounds 2 · cell-fracture 2 · clone 2 · configurator 2 · decal 2 · fisheye 2 · gobo 2 · god-rays 2 · hdr 2 · horizontal 2 · interaction 2 · lighting 2 · lod 2 · lut 2 · mask 2 · merging 2 · noise 2 · pcss 2 · re-use 2 · shadows 2 · spotlight 2 · stage 2 · suspense 2 · texture 2 · trail 2 · vertex-colors 2 · vertical 2 · video-texture 2 · views 2 · aspect-ratio 1 · backdrop 1 · baking 1 · barycentric 1 · batching 1 · blur 1 · bones 1 · chromatic-aberration 1 · compression 1 · convex-polyhedron 1 · custom-renderer 1 · debug 1 · depth 1 · distortion 1 · dot-screen 1 · expand 1 · film 1 · flexbox 1 · geometry 1 · gpgpu 1 · grid 1 · highlight 1 · hmr 1 · hud 1 · intersection 1 · lerp 1 · lightformer 1 · lightmap 1 · loading 1 · occlusion 1 · parallax 1 · pixelation 1 · progressive 1 · rectarea-lights 1 · scanline 1 · selection 1 · selective 1 · sepia 1 · snap 1 · soft-particles 1 · ssgi 1 · svg 1 · text-geometry 1 · vignette 1 · wireframe 1

Merges and renames

gtlf → gltf · clell-fracture → cell-fracture · shaders → shader · animations → animation · portals → portal · instancing → instances · trails → trail · springs → spring · spring-animation → spring · decals → decal · godray → god-rays · softshadows → soft-shadows · shadow → shadows · contact shadows → contact-shadows · scrollcontrols → scroll · scroll-controls → scroll · depth-of-field → dof · markers → annotations · html-annotations → annotations · glow → bloom · fit-all → bounds · grading → lut · gpu → gpgpu · curl → noise · simplex → noise · merged → merging · pointer-events → events · layout → flexbox · svg-renderer → custom-renderer · lights → lighting · spot → spotlight · orbit → controls · orbit-controls → controls · transform → controls · transforms → controls · transform-controls → controls · custom-controls → controls · pointerlock-controls → controls · box projected → ground-projection · ground mapping → ground-projection · cube camera → ground-projection · video → video-texture

Evicted — API names, subjects, and category words a sibling tag already said

meshreflectormaterial · rendertexture · useanimations · quadraticbezierline · line2 · useintersect · skinnedmesh · meshline · mesh-line · arkanoid · minecraft · pinball · tag-heuer · codrops · baubles · drone · shield · epoxy · diamond · ring · stars · grass · confetti · racing · vehicle · cycling · ragdoll · viewcube · minimap · fire · water · tiles · dome · graph · nodes · image · spline · clouds · frosted-glas · metal · effects · distance · input · analyser · positional

Multi-selection, and why it needs the disabling

Tags AND together. On its own that is a trap: 117 tags make 6,786 pairs, 336 of which occur together at all, and 263 of those on a single example — so a second click empties the list about nineteen times in twenty, which is the one thing the vocabulary was rebuilt to avoid.

So the second click is not offered when it would. TagFilterProvider indexes the catalog by tag once, useTagFilter intersects that with the tags picked so far, and a badge that would leave nothing goes disabled. It weighs the tags alone, not ?q= or ?library= — a pill greyed out because of what sits in the search box reads as broken rather than as narrow.

The cards need none of this and get it for free: a card is in the list because it carries every active tag, so every pill on it has at least that card behind it and can never be the one that empties it. It is the info panel, whose example may not be in the list at all, where a tag can be a dead end.

The UI, and the two things that had to move for it

Clicking a tag is the only way in — there is no picker. With most tags on a single example a menu of 117 is not something anyone reads, whereas "show me the others like this one" is the gesture people actually have. The pressed badge is therefore also the answer to "why is this list short" and "how do I undo it", and it leads its card's strip — otherwise a card can be filtered by a tag its four visible pills do not show.

• The card is no longer an anchor. A button inside an <a> is as invalid as an anchor inside one, so the whole clickable rectangle now comes from a stretched link the pills sit above.
• The roving tabindex claimed every button in the list, which would have turned one tab stop per card into five. The pills opt out with data-roving-skip and stay a pointer affordance; the keyboard reaches the same tags from the info panel.
• NuqsAdapter moved up to cover main — the info panel is a nuqs consumer now, and its comment said Nav was the only one.

Checked

pnpm lint · pnpm lint:metadata (170 examples) · pnpm format:check · tsc --noEmit · vitest (55) — and by hand in the running site: filter from a card pill (23 for physics), a second tag on top (?tag=physics,game → 7), transmission going grey on the aquarium while those two are held, zero disabled pills on any card, filter from the info panel, toggle off, the active tags leading each strip, the stretched link carrying ?tag= into the example, and 17 pills at tabindex="-1" against exactly one tabbable link in the list.