Skip to content

Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.

fix(animations): announce the preview spinner and document the gallery's real thumbnail and dialog behaviour

nirholas0f26269eced9
diff --git a/docs/animations.md b/docs/animations.md
index b7818adcd..5cb90eda7 100644
--- a/docs/animations.md
+++ b/docs/animations.md
@@ -128,10 +128,11 @@ Its measured companion is `public/animations/signatures.json`: a motion-signatur
[three.ws/animations](https://three.ws/animations) is the public browse surface over every clip: the curated studio manifest, the full R2-hosted motion-capture library (`GET /api/animations/library`, ~2,900 clips; `total` on that response is the live count), and community-published clips (`GET /api/animations/clips?visibility=public`).
-- **Poster thumbnails** — every clip has a WebP still of the preview avatar posed mid-motion. Rendered offline by `node scripts/build-animation-thumbnails.mjs` (drives `scripts/thumbnail-harness.html` in headless Chromium through the site's own retarget engine). Curated thumbs are committed at `public/animations/thumbs/<name>.webp`; library thumbs upload to R2 alongside their clips via `npm run mixamo:upload`, which publishes each one as the manifest entry's `thumb` URL. Added a clip? Re-run the thumbnail script, then re-upload.
+- **Poster thumbnails**: a WebP still of the preview avatar posed mid-motion, rendered offline by `node scripts/build-animation-thumbnails.mjs` (which drives `scripts/thumbnail-harness.html` in headless Chromium through the site's own retarget engine). Curated thumbs are committed at `public/animations/thumbs/<name>.webp`; library thumbs upload to R2 alongside their clips via `npm run mixamo:upload`, which publishes each one as the manifest entry's `thumb` URL. Added a clip? Re-run the thumbnail script, then re-upload. **The library manifest's `thumb` field is the only source of truth for a library thumbnail.** Coverage is partial (853 of 2,874 entries carry no `thumb` as of 2026-08-16), and the gallery renders the clip's icon for those instead of guessing a CDN path: the guess 404s on every one of them, which cost a blocked cross-origin request per card.
- **Categories** — the Mixamo catalog carries no category metadata, so `src/animation-categories.js` derives one per clip from its label (ordered keyword rules; curated clips keep their hand-assigned `animation-presets.js` category). Covered by `tests/animation-categories.test.js`, which also asserts <10% of the real library falls into the "More" catch-all.
- **Live previews** — one shared WebGL engine (`src/animations-live-preview.js`) serves every card hover and the detail modal: a single renderer + preview avatar; the canvas moves into whichever card is previewing. Nothing 3D loads until the first hover.
-- **Deep links** — `?clip=<id>` opens a clip's detail modal directly; `q`, `cat`, `filter`, and `sort` round-trip through the URL so filtered views are shareable.
+- **Deep links**: `?clip=<id>` opens a clip's detail modal directly; `q`, `cat`, `filter`, and `sort` round-trip through the URL so filtered views are shareable. Every one of them is validated against the values the controls can represent, so a hand-edited `?sort=bogus` falls back to `featured` rather than blanking the sort menu, and an arriving `?filter=once` presses the matching segmented button instead of filtering invisibly.
+- **Detail modal**: a real dialog. Focus moves into it on open, Tab wraps inside it, Escape closes it and returns focus to the card that opened it. Arrow keys step through the filtered list (except while a slider is focused, which owns its own arrows), and Space toggles playback. The transport row only appears once a clip is actually on the stage, so a preview that fails to load shows the error and its Studio link rather than controls that do nothing.
## Known issues
diff --git a/pages/animations.html b/pages/animations.html
index e33a9ca0e..ad0a8c0e9 100644
--- a/pages/animations.html
+++ b/pages/animations.html
@@ -834,7 +834,7 @@
<div class="ag-modal-card">
<div class="ag-modal-stage-wrap">
<div class="ag-modal-stage" data-role="modal-stage"></div>
- <div class="ag-modal-spinner" data-role="modal-spinner" aria-label="Loading preview"></div>
+ <div class="ag-modal-spinner" data-role="modal-spinner" role="status" aria-label="Loading preview" data-i18n-attr="aria-label:animations.loading_preview_arialabel"></div>
<div class="ag-modal-error" data-role="modal-error" hidden>
<span data-i18n="animations.couldn_t_load_this_clip_s_preview">⚠️ Couldn't load this clip's preview.</span>
<span data-i18n="animations.you_can_still_open_it_in_the">You can still open it in the Studio.</span>
diff --git a/public/locales/en.json b/public/locales/en.json
index 48d7b652d..fc3dd4c41 100644
--- a/public/locales/en.json
+++ b/public/locales/en.json
@@ -1103,6 +1103,7 @@
"every_clip_in_the_three_ws_motion": "Every clip in the three.ws motion library: mocap performances, studio presets, and community-authored animations. Hover any card for a live preview, open the details for playback controls, or send it straight to the Studio.",
"featured": "Featured",
"load_more": "Load more",
+ "loading_preview_arialabel": "Loading preview",
"longest_first": "Longest first",
"loops": "Loops",
"meta_description": "Browse 2,000+ motion-capture and community animations for three.ws avatars. Live previews, categories, and one-click use in the Animation Studio.",