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(a11y): give icon-only buttons real tooltips and make gallery, create and header names match their visible text, with 8px control gaps and an explicit page background

nirholasf772c87088d2
diff --git a/data/changelog.json b/data/changelog.json
index 3b4eba557..332b4adfd 100644
--- a/data/changelog.json
+++ b/data/changelog.json
@@ -30154,6 +30154,15 @@
"feature"
],
"link": "/desktop"
+ },
+ {
+ "date": "2026-10-12",
+ "title": "Accessibility pass on the gallery, create page and site header",
+ "summary": "Icon-only buttons in the header, footer and suggestions panel now show a real tooltip on hover and keyboard focus. Gallery tags, avatar cards and the create page cards are announced with the text you can see, header buttons have more breathing room, and the page background no longer flashes transparent when you overscroll.",
+ "tags": [
+ "improvement"
+ ],
+ "link": "/gallery"
}
]
}
diff --git a/docs/ui-lint.md b/docs/ui-lint.md
index c93990d0c..0f1f10403 100644
--- a/docs/ui-lint.md
+++ b/docs/ui-lint.md
@@ -15,3 +15,7 @@ Exit codes: 0 pass, 1 findings, 2 the check could not finish (pages over 5000 el
- The policy ships with Apple system fonts and a 12 to 64px type scale. three.ws uses Inter, Space Grotesk and JetBrains Mono and a denser scale, so the font and size rules are noisy until the policy is tuned to our design tokens. The rules that carry signal today are `viewport-bounds`, `content-clipping`, `control-gap`, `root-background` and `control-state`.
- The home page is a windowed-desktop canvas with a plain HTML fallback behind it. Lint content pages (`/gallery`, `/create`) and pass `--ready` so the app has mounted.
- A passing run means the configured rules held. It is not a design review.
+
+## Triage (2026-10-12)
+
+First pass on `/gallery` and `/create` fixed the rules with signal: control gaps in the header and gallery, accessible names that dropped visible text (gallery tags and cards, create cards, the getting-started pill), icon-only buttons without a tooltip (header, footer, suggestions panel; use a `role="tooltip"` span linked by `aria-describedby`, styled by `.ui-tip`), and the root background. What remains is intentional or environmental: the skip link and visually hidden label sit off-screen on purpose, card titles and descriptions use `line-clamp`, the footer watermark bleeds by design, `Inter Fallback` fails to load only where Arial/Liberation Sans is not installed, and the walk companion's floating buttons are 22px circles (44px on coarse pointers).
diff --git a/pages/create.html b/pages/create.html
index d461c4da4..135a96420 100644
--- a/pages/create.html
+++ b/pages/create.html
@@ -110,6 +110,9 @@
margin: 0;
padding: 0;
}
+ html {
+ background: #050505;
+ }
body {
font:
15px/1.55 -apple-system,
@@ -1335,7 +1338,7 @@
<div class="picker-reassure" data-crypto-optional="compact"></div>
</div>
<div class="intent-grid" role="group" aria-label="Choose what to create">
- <a class="intent-card" href="/create-agent" aria-label="Build an AI agent — name it, give it a body, skills, voice, and an on-chain identity" data-i18n-attr="aria-label:create.build_an_ai_agent_name_it_gi_arialabel">
+ <a class="intent-card" href="/create-agent">
<span class="intent-card-icon" aria-hidden="true">
<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.7" stroke-linecap="round" stroke-linejoin="round">
<rect x="4" y="8" width="16" height="12" rx="3" />
@@ -1349,7 +1352,7 @@
<h2 class="intent-card-title">Build an AI agent</h2>
<p class="intent-card-sub">Avatar, brain, skills, voice, and an on-chain identity — the full wizard.</p>
</a>
- <a class="intent-card is-current" href="#avatar-options" aria-label="You're here: make a 3D avatar, jump to the avatar options below on this page" data-i18n-attr="aria-label:create.make_a_3d_avatar_jump_to_the_arialabel">
+ <a class="intent-card is-current" href="#avatar-options" aria-current="location">
<span class="intent-card-tag">You're here</span>
<span class="intent-card-icon" aria-hidden="true">
<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.7" stroke-linecap="round" stroke-linejoin="round">
@@ -1360,7 +1363,7 @@
<h2 class="intent-card-title">Make a 3D avatar</h2>
<p class="intent-card-sub">From a photo, from scratch, from a text prompt (typed or spoken), or upload a file.</p>
</a>
- <a class="intent-card" href="/forge" aria-label="Generate a 3D model from a text prompt, photo, multiple photos, a drawing, or your voice" data-i18n-attr="aria-label:create.generate_a_3d_model_from_a_t_arialabel">
+ <a class="intent-card" href="/forge">
<span class="intent-card-icon" aria-hidden="true">
<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.7" stroke-linecap="round" stroke-linejoin="round">
<path d="M12 3l8 4.5v9L12 21l-8-4.5v-9z" />
@@ -1370,7 +1373,7 @@
<h2 class="intent-card-title">Generate a 3D model</h2>
<p class="intent-card-sub">Any object or prop — not just avatars. Type it, speak it, upload up to 4 photos for a sharper mesh, or draw it right in the browser.</p>
</a>
- <a class="intent-card" href="/launchpad" aria-label="Launch a token world" data-i18n-attr="aria-label:create.launch_a_token_world_arialabel">
+ <a class="intent-card" href="/launchpad">
<span class="intent-card-icon" aria-hidden="true">
<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.7" stroke-linecap="round" stroke-linejoin="round">
<circle cx="12" cy="12" r="9" />
@@ -1412,7 +1415,6 @@
id="card-default-editor"
role="button"
tabindex="0"
- aria-label="Customize a base avatar in our in-browser editor (recommended)"
>
<span class="recommended-badge" aria-hidden="true" data-i18n="create.recommended">Recommended</span>
<div class="hero-card-body">
@@ -1499,7 +1501,6 @@
id="card-prompt"
role="button"
tabindex="0"
- aria-label="Describe it to 3D: describe an avatar in words and generate it in 3D, now live"
>
<div class="card-icon-row">
<div class="card-icon" aria-hidden="true">
@@ -1557,7 +1558,6 @@
id="card-customize"
role="button"
tabindex="0"
- aria-label="Start with a ready-made template"
>
<div class="card-icon-row">
<div class="card-icon" aria-hidden="true">
@@ -1609,7 +1609,6 @@
id="card-selfie"
role="button"
tabindex="0"
- aria-label="Scan yourself to 3D: scan yourself into a 3D avatar"
>
<div class="card-icon-row">
<div class="card-icon" aria-hidden="true">
@@ -1660,7 +1659,6 @@
id="card-video-avatar"
role="button"
tabindex="0"
- aria-label="Generate a talking avatar video"
>
<div class="card-icon-row">
<div class="card-icon" aria-hidden="true">
@@ -1711,7 +1709,6 @@
id="card-cosmos"
role="button"
tabindex="0"
- aria-label="Bring your avatar to life with a Cosmos living world"
>
<div class="card-icon-row">
<div class="card-icon" aria-hidden="true">
@@ -1743,7 +1740,6 @@
id="card-upload-glb"
role="button"
tabindex="0"
- aria-label="Upload your own GLB: upload a GLB file"
>
<div class="card-icon-row">
<div class="card-icon" aria-hidden="true">
@@ -1793,7 +1789,6 @@
id="card-agent-studio"
role="button"
tabindex="0"
- aria-label="Try the Avatar Studio (beta)"
>
<div class="card-icon-row">
<div class="card-icon" aria-hidden="true">
diff --git a/public/footer.css b/public/footer.css
index a733c43ac..923d590c9 100644
--- a/public/footer.css
+++ b/public/footer.css
@@ -680,3 +680,14 @@
font-size: max(16px, 1em);
}
}
+
+.h-footer-newsletter-btn { position: relative; }
+.h-footer-newsletter-btn > .ui-tip {
+ position: absolute; bottom: calc(100% + 8px); right: 0;
+ padding: 5px 9px; border-radius: 6px; white-space: nowrap;
+ font-size: 12px; font-weight: 500; line-height: 1.3;
+ color: #f2f0ff; background: #16161f; border: 1px solid rgba(255,255,255,0.14);
+ opacity: 0; pointer-events: none; transition: opacity 120ms; z-index: 10;
+}
+.h-footer-newsletter-btn:hover > .ui-tip, .h-footer-newsletter-btn:focus-visible > .ui-tip { opacity: 1; }
+@media (prefers-reduced-motion: reduce) { .h-footer-newsletter-btn > .ui-tip { transition: none; } }
diff --git a/public/footer.html b/public/footer.html
index 233ac20ab..8f7853c85 100644
--- a/public/footer.html
+++ b/public/footer.html
@@ -21,9 +21,9 @@
autocomplete="email"
required
/>
- <button type="submit" class="h-footer-newsletter-btn" aria-label="Subscribe" data-i18n-attr="aria-label:footer.subscribe_arialabel">
+ <button type="submit" class="h-footer-newsletter-btn" aria-label="Subscribe" aria-describedby="footer-tip-subscribe" data-i18n-attr="aria-label:footer.subscribe_arialabel">
<svg viewBox="0 0 16 16" aria-hidden="true"><path fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round" d="M2 8h11m0 0L9 4m4 4l-4 4"/></svg>
- </button>
+ <span class="ui-tip" role="tooltip" id="footer-tip-subscribe">Subscribe</span></button>
</form>
<p class="h-footer-newsletter-msg" data-newsletter-msg aria-live="polite"></p>
</div>
diff --git a/public/gallery/gallery.css b/public/gallery/gallery.css
index 73d501f0d..3c750521e 100644
--- a/public/gallery/gallery.css
+++ b/public/gallery/gallery.css
@@ -6,6 +6,7 @@
*/
html:has(body.gallery-page) {
+ background: #050505;
height: auto;
overflow: auto;
}
@@ -602,7 +603,7 @@ body.gallery-page {
.gallery-card-actions {
display: inline-flex;
flex-wrap: wrap;
- gap: 6px;
+ gap: 8px;
}
.gallery-card-btn {
font-size: 12px;
@@ -1111,7 +1112,7 @@ body.gallery-page {
.gallery-cats {
display: flex;
flex-wrap: wrap;
- gap: 0.4rem;
+ gap: 0.5rem;
}
/* ── Equip modal — accessory-to-avatar picker ────────────────── */
diff --git a/public/gallery/gallery.js b/public/gallery/gallery.js
index 1baa292a9..fde6c4cf3 100644
--- a/public/gallery/gallery.js
+++ b/public/gallery/gallery.js
@@ -436,7 +436,7 @@ function renderPopular() {
const label = active ? `Clear the ${s.query} search` : `Search for ${s.query}`;
return `<button type="button" class="gallery-tag gallery-pop${active ? ' is-active' : ''}" data-pop="${escapeAttr(
s.query,
- )}" aria-pressed="${active}" aria-label="${escapeAttr(label)}">${thumb}<span>${escapeHtml(
+ )}" aria-pressed="${active}" title="${escapeAttr(label)}">${thumb}<span>${escapeHtml(
s.query,
)}</span>${count}</button>`;
})
@@ -519,7 +519,7 @@ function renderCard(a) {
const rigBadge = window.twsRig?.rigBadgeHTML ? window.twsRig.rigBadgeHTML(a) : '';
card.innerHTML = `
- <a class="gallery-card-thumb" href="${escapeAttr(detailUrl)}" aria-label="Open ${escapeAttr(a.name || 'Avatar')}">
+ <a class="gallery-card-thumb" href="${escapeAttr(detailUrl)}" aria-label="Open ${escapeAttr(a.name || 'Avatar')} in 3D${rigBadge ? ', rigged' : ''}">
${thumbContent}
<span class="gallery-card-3dpill">3D</span>
${rigBadge ? `<span class="gallery-card-rig">${rigBadge}</span>` : ''}
diff --git a/public/getting-started.js b/public/getting-started.js
index 087407572..3edd942f5 100644
--- a/public/getting-started.js
+++ b/public/getting-started.js
@@ -225,8 +225,8 @@
pill.setAttribute(
'aria-label',
complete
- ? 'Getting started: all core steps complete. Open checklist.'
- : 'Getting started: ' + done + ' of ' + total + ' steps done. Open checklist.'
+ ? 'Getting started ✓ Done: all core steps complete. Open checklist.'
+ : 'Getting started ' + done + '/' + total + ': ' + done + ' of ' + total + ' steps done. Open checklist.'
);
}
diff --git a/public/nav.css b/public/nav.css
index 402c45c52..810da3b4d 100644
--- a/public/nav.css
+++ b/public/nav.css
@@ -85,7 +85,7 @@
.nav-mi[aria-current="page"] .nav-mi-t { color: var(--nv-text); }
.nav-mi[aria-current="page"] { background: var(--nv-surface-1); }
.nav-drawer a[aria-current="page"] { color: var(--nv-text); background: var(--nv-surface-1); }
-.nav-end { display: flex; align-items: center; gap: 4px; }
+.nav-end { display: flex; align-items: center; gap: 8px; }
.nav-end a {
display: inline-flex; align-items: center;
padding: 7px 12px; font-size: var(--text-ui); font-weight: 450; color: var(--nv-text-2);
@@ -810,3 +810,19 @@ html:not(.tws-lite) .nav-tier-toggle .nav-tier-less { display: inline; }
.nav-drawer button.dr-tier:active {
border-color: var(--nv-hairline-strong); background: var(--nv-surface-1); color: var(--nv-text);
}
+
+/* Tooltip for icon-only buttons: a real role="tooltip" node linked by
+ aria-describedby, shown on hover and keyboard focus. */
+.ui-tip {
+ position: absolute; top: calc(100% + 8px); right: 0;
+ padding: 5px 9px; border-radius: 6px; white-space: nowrap;
+ font-size: 12px; font-weight: 500; line-height: 1.3;
+ color: #f2f0ff; background: #16161f; border: 1px solid rgba(255,255,255,0.14);
+ box-shadow: 0 8px 24px rgba(0,0,0,0.4);
+ opacity: 0; transform: translateY(-2px); pointer-events: none;
+ transition: opacity var(--duration-fast, 120ms), transform var(--duration-fast, 120ms);
+ z-index: 1000;
+}
+button:hover > .ui-tip, button:focus-visible > .ui-tip { opacity: 1; transform: none; }
+.nav-theme-btn, .nav-toggle { position: relative; }
+@media (prefers-reduced-motion: reduce) { .ui-tip { transition: none; } }
diff --git a/public/nav.html b/public/nav.html
index 452afca01..0d7fb4a24 100644
--- a/public/nav.html
+++ b/public/nav.html
@@ -13,9 +13,9 @@
type="button"
class="nav-search-btn"
data-search-open
- aria-label="Search (Cmd K)"
+ aria-keyshortcuts="Meta+K Control+K"
title="Search"
- data-i18n-attr="aria-label:nav.search_cmd_k_arialabel;title:nav.search_title">
+ data-i18n-attr="title:nav.search_title">
<svg
class="nav-search-ico"
width="14"
@@ -50,8 +50,8 @@
id="nav-theme-toggle"
aria-pressed="false"
aria-label="Switch to light theme"
- title="Toggle theme"
- data-i18n-attr="aria-label:nav.switch_to_light_theme_arialabel;title:nav.toggle_theme_title">
+ aria-describedby="nav-tip-theme"
+ data-i18n-attr="aria-label:nav.switch_to_light_theme_arialabel">
<svg
class="nav-theme-ico moon"
viewBox="0 0 20 20"
@@ -81,6 +81,7 @@
<circle cx="10" cy="10" r="3.6" />
<path d="M10 2v2M10 16v2M2 10h2M16 10h2M4.2 4.2l1.4 1.4M14.4 14.4l1.4 1.4M4.2 15.8l1.4-1.4M14.4 5.6l1.4-1.4" />
</svg>
+ <span class="ui-tip" role="tooltip" id="nav-tip-theme">Toggle theme</span>
</button>
<!-- $THREE holder tier chip — hydrated by /nav-tier-badge.js (mountTierBadge).
Stays hidden for anonymous visitors and non-holders. -->
@@ -92,8 +93,8 @@
aria-label="Notifications"
aria-expanded="false"
aria-haspopup="dialog"
- title="Notifications"
- data-i18n-attr="aria-label:nav.notifications_arialabel;title:nav.notifications_title">
+ aria-describedby="nav-tip-notif"
+ data-i18n-attr="aria-label:nav.notifications_arialabel">
<svg
class="nav-notif-ico"
viewBox="0 0 20 20"
@@ -110,6 +111,7 @@
<path d="M11.73 17a2 2 0 0 1-3.46 0" />
</svg>
<span class="nav-notif-badge" hidden aria-live="polite"></span>
+ <span class="ui-tip" role="tooltip" id="nav-tip-notif">Notifications</span>
</button>
<!-- "Where did the thing I just made go?" is answered here: the one-click way back to
everything you built. Signed-in only; signed-out visitors reach it
@@ -127,7 +129,7 @@
<a href="/login" id="home-nav-cta" data-auth="out" data-i18n="nav.w9nig3">Sign in</a>
<a class="console" href="/dashboard" id="home-nav-user" data-auth-name data-i18n="nav.15pjwv8">Console →</a>
</div>
- <button type="button" class="nav-toggle" aria-label="Menu" aria-expanded="false" id="nav-toggle" data-i18n-attr="aria-label:nav.menu_arialabel">
+ <button type="button" class="nav-toggle" aria-label="Menu" aria-describedby="nav-tip-menu" aria-expanded="false" id="nav-toggle" data-i18n-attr="aria-label:nav.menu_arialabel">
<svg
class="open"
viewBox="0 0 16 16"
@@ -151,6 +153,7 @@
<line x1="3" y1="3" x2="13" y2="13" />
<line x1="13" y1="3" x2="3" y2="13" />
</svg>
+ <span class="ui-tip" role="tooltip" id="nav-tip-menu">Menu</span>
</button>
</div>
</header>
diff --git a/public/next-steps.js b/public/next-steps.js
index 919c85b95..4b9b948fc 100644
--- a/public/next-steps.js
+++ b/public/next-steps.js
@@ -162,6 +162,9 @@
'#tws-next-steps .tn-head{display:flex;align-items:center;justify-content:space-between;gap:12px;margin:0 0 12px}' +
'#tws-next-steps .tn-lead{margin:0;font-size:15px;font-weight:600}' +
'#tws-next-steps .tn-x{width:32px;height:32px;font-size:18px;line-height:1;color:inherit;opacity:.6;background:none;border:0;border-radius:8px;cursor:pointer}' +
+ '#tws-next-steps .tn-x{position:relative}' +
+ '#tws-next-steps .tn-x>.ui-tip{position:absolute;bottom:calc(100% + 6px);right:0;padding:4px 8px;border-radius:6px;font-size:12px;white-space:nowrap;color:#f2f0ff;background:#16161f;opacity:0;pointer-events:none;transition:opacity .12s}' +
+ '#tws-next-steps .tn-x:hover>.ui-tip,#tws-next-steps .tn-x:focus-visible>.ui-tip{opacity:1}' +
'#tws-next-steps .tn-x:hover{opacity:1;background:rgba(128,128,160,.18)}' +
'#tws-next-steps .tn-grid{display:grid;grid-template-columns:repeat(auto-fit,minmax(200px,1fr));gap:10px}' +
'#tws-next-steps .tn-card{display:block;padding:12px 14px;color:inherit;text-decoration:none;border:1px solid rgba(128,128,160,.28);border-radius:12px;transition:background .15s,border-color .15s,transform .1s}' +
@@ -189,7 +192,14 @@
close.type = 'button';
close.className = 'tn-x';
close.setAttribute('aria-label', 'Dismiss suggestions');
- close.textContent = '×';
+ close.setAttribute('aria-describedby', 'tn-x-tip');
+ close.innerHTML = '<span aria-hidden="true">×</span>';
+ var tip = document.createElement('span');
+ tip.className = 'ui-tip';
+ tip.id = 'tn-x-tip';
+ tip.setAttribute('role', 'tooltip');
+ tip.textContent = 'Dismiss suggestions';
+ close.appendChild(tip);
close.addEventListener('click', function () {
remember();
wrap.remove();