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.
JavaScript 3d-generationai-agentsanimationavatardigital-humangenerative-aiglbgltfimage-to-3dllmmcpmcp-servermodel-context-protocolsolanatext-to-3dthreejsweb-componentswebglwebxrx402
/* three.ws "Getting started" guide — the first-run path + resumable checklist.
*
* Self-mounting widget (public/getting-started.js). Renders a low-key launcher
* pill bottom-right that expands into a progress checklist, plus a one-time
* welcome modal for brand-new visitors on the homepage. Tokens fall back to
* literals so the widget looks right on pages that don't load style.css.
*
* Layout note: the activity feed owns bottom-left, the Walk Companion owns the
* far bottom-right corner; this guide sits bottom-right but is opt-in/dismissible
* and primarily targets brand-new visitors (no companion enabled), so overlap is
* rare. z-index sits above the feed and below the modal overlay. */
.twg-root {
position: fixed;
right: 18px;
bottom: 18px;
z-index: 2147482500; /* above feed (…482000), below Walk Companion (…483000) */
font-family: var(--font-body, 'Inter', system-ui, -apple-system, 'Segoe UI', sans-serif);
-webkit-font-smoothing: antialiased;
}
.twg-root[hidden] { display: none !important; }
/* ── Launcher pill ─────────────────────────────────────────────────────────── */
.twg-pill {
display: inline-flex;
align-items: center;
gap: 8px;
height: 36px;
padding: 0 13px 0 10px;
border: 1px solid rgba(255, 255, 255, 0.14);
border-radius: 999px;
background: rgba(16, 17, 23, 0.94);
backdrop-filter: blur(16px) saturate(1.4);
-webkit-backdrop-filter: blur(16px) saturate(1.4);
color: rgba(255, 255, 255, 0.80);
font: 600 12.5px/1 var(--font-body, 'Inter', system-ui, sans-serif);
cursor: pointer;
box-shadow: 0 4px 20px rgba(0, 0, 0, 0.45), 0 1px 0 rgba(255, 255, 255, 0.05) inset;
transition: transform var(--duration-fast) var(--ease-standard), border-color var(--duration-fast) var(--ease-standard), box-shadow var(--duration-fast) var(--ease-standard), color var(--duration-fast) var(--ease-standard);
}
.twg-pill:hover {
transform: translateY(-2px);
border-color: rgba(255, 255, 255, 0.28);
box-shadow: 0 8px 28px rgba(0, 0, 0, 0.5), 0 1px 0 rgba(255, 255, 255, 0.07) inset;
color: rgba(255, 255, 255, 0.96);
}
.twg-pill:focus-visible {
outline: 2px solid var(--accent, #fff);
outline-offset: 2px;
}
.twg-pill[hidden] { display: none; }
/* Compass / sparkle glyph in a ring that doubles as a progress ring. */
.twg-pill-ring {
position: relative;
width: 18px;
height: 18px;
flex: 0 0 auto;
border-radius: 50%;
display: grid;
place-items: center;
background: conic-gradient(rgba(255, 255, 255, 0.7) calc(var(--twg-pct, 0) * 1%), rgba(255, 255, 255, 0.12) 0);
transition: background var(--duration-slow) var(--ease-standard);
}
.twg-pill-ring::after {
content: '';
position: absolute;
inset: 2px;
border-radius: 50%;
background: #141519;
}
.twg-pill-glyph {
position: relative;
z-index: 1;
font-size: 10px;
line-height: 1;
}
.twg-pill-label { white-space: nowrap; letter-spacing: -0.01em; }
.twg-pill-count {
font-variant-numeric: tabular-nums;
/* The pill is a permanently dark surface, so its ink cannot come from a token
that flips with the page theme: in light mode --ink-dim resolves to #5a616f
and reads at 2.6:1 on this background. Fixed light-on-dark, like the rest of
the pill. */
color: #a1a1aa;
font-weight: 500;
}
.twg-pill.is-complete .twg-pill-count { color: var(--success); }
.twg-pill.is-complete {
border-color: rgba(74, 222, 128, 0.25);
box-shadow: 0 4px 20px rgba(0, 0, 0, 0.45), 0 0 0 1px rgba(74, 222, 128, 0.08);
}
/* ── Panel ─────────────────────────────────────────────────────────────────── */
.twg-panel {
position: absolute;
right: 0;
bottom: 0;
width: 330px;
max-width: calc(100vw - 32px);
max-height: min(540px, calc(100vh - 90px));
display: flex;
flex-direction: column;
border: 1px solid rgba(255, 255, 255, 0.11);
border-radius: 18px;
background: rgba(15, 16, 22, 0.98);
backdrop-filter: blur(24px) saturate(1.4);
-webkit-backdrop-filter: blur(24px) saturate(1.4);
box-shadow: 0 24px 64px rgba(0, 0, 0, 0.60), 0 1px 0 rgba(255, 255, 255, 0.06) inset;
color: rgba(255, 255, 255, 0.85);
overflow: hidden;
transform-origin: bottom right;
animation: twg-pop 0.22s cubic-bezier(0.16, 1, 0.3, 1);
}
.twg-panel[hidden] { display: none; }
@keyframes twg-pop {
from { opacity: 0; transform: translateY(10px) scale(0.95); }
to { opacity: 1; transform: translateY(0) scale(1); }
}
.twg-head {
display: flex;
align-items: flex-start;
gap: 10px;
padding: 16px 15px 13px;
border-bottom: 1px solid rgba(255, 255, 255, 0.07);
}
.twg-head-text { flex: 1; min-width: 0; }
.twg-title {
margin: 0;
font: 700 13.5px/1.2 var(--font-display, 'Space Grotesk', 'Inter', sans-serif);
letter-spacing: -0.01em;
color: rgba(255, 255, 255, 0.95);
}
.twg-sub {
margin: 3px 0 0;
font-size: 11.5px;
color: rgba(255, 255, 255, 0.38);
line-height: 1.3;
}
.twg-close {
flex: 0 0 auto;
width: 24px;
height: 24px;
display: grid;
place-items: center;
border: none;
border-radius: 7px;
background: transparent;
color: rgba(255, 255, 255, 0.35);
font-size: 17px;
line-height: 1;
cursor: pointer;
transition: background var(--duration-fast) var(--ease-standard), color var(--duration-fast) var(--ease-standard);
}
.twg-close:hover { background: rgba(255, 255, 255, 0.07); color: rgba(255, 255, 255, 0.80); }
.twg-close:focus-visible { outline: 2px solid var(--accent, #fff); outline-offset: 1px; }
/* Progress bar under the header. */
.twg-bar {
height: 2px;
background: rgba(255, 255, 255, 0.06);
overflow: hidden;
}
.twg-bar-fill {
height: 100%;
width: 0;
background: rgba(255, 255, 255, 0.5);
border-radius: 0 2px 2px 0;
transition: width var(--duration-slow) var(--ease-standard);
}
.twg-panel.is-complete .twg-bar-fill { background: var(--success, #4ade80); }
.twg-list {
margin: 0;
padding: 5px;
list-style: none;
overflow-y: auto;
flex: 1;
}
.twg-section-label {
display: flex;
align-items: center;
gap: 8px;
padding: 10px 8px 4px;
font-size: 9.5px;
font-weight: 700;
letter-spacing: 0.09em;
text-transform: uppercase;
color: rgba(255, 255, 255, 0.28);
}
.twg-section-label::after {
content: '';
flex: 1;
height: 1px;
background: rgba(255, 255, 255, 0.07);
}
/* Each step is a button/link row. */
.twg-step {
display: flex;
align-items: flex-start;
gap: 10px;
width: 100%;
padding: 9px 8px;
border: 1px solid transparent;
border-radius: 11px;
background: transparent;
color: inherit;
text-align: left;
text-decoration: none;
cursor: pointer;
transition: background var(--duration-fast) var(--ease-standard), border-color var(--duration-fast) var(--ease-standard);
}
.twg-step:hover {
background: rgba(255, 255, 255, 0.04);
border-color: rgba(255, 255, 255, 0.07);
}
.twg-step:focus-visible { outline: 2px solid var(--accent, #fff); outline-offset: 1px; }
.twg-step-mark {
flex: 0 0 auto;
width: 21px;
height: 21px;
margin-top: 1px;
border-radius: 50%;
border: 1.5px solid rgba(255, 255, 255, 0.18);
display: grid;
place-items: center;
font-size: 10px;
font-weight: 700;
color: rgba(255, 255, 255, 0.3);
transition: background var(--duration-base) var(--ease-standard), border-color var(--duration-base) var(--ease-standard), color var(--duration-base) var(--ease-standard);
}
.twg-step-body { flex: 1; min-width: 0; }
.twg-step-title {
display: flex;
align-items: center;
gap: 6px;
font-size: 12.5px;
font-weight: 600;
color: rgba(255, 255, 255, 0.85);
}
.twg-step-desc {
margin-top: 2px;
font-size: 11px;
line-height: 1.4;
color: rgba(255, 255, 255, 0.35);
}
.twg-step-arrow {
flex: 0 0 auto;
align-self: center;
color: rgba(255, 255, 255, 0.28);
opacity: 0;
transform: translateX(-4px);
transition: opacity var(--duration-fast) var(--ease-standard), transform var(--duration-fast) var(--ease-standard);
}
.twg-step:hover .twg-step-arrow { opacity: 1; transform: translateX(0); }
.twg-tag {
font-size: 9px;
font-weight: 700;
letter-spacing: 0.05em;
text-transform: uppercase;
padding: 1.5px 5px;
border-radius: 999px;
border: 1px solid rgba(255, 255, 255, 0.14);
color: rgba(255, 255, 255, 0.35);
}
/* Completed state. */
.twg-step.is-done .twg-step-mark {
background: var(--success, #4ade80);
border-color: var(--success, #4ade80);
color: #06210f;
}
.twg-step.is-done .twg-step-title { color: rgba(255, 255, 255, 0.32); }
.twg-step.is-done .twg-step-desc { color: rgba(255, 255, 255, 0.20); }
.twg-step.is-done .twg-step-title .twg-tag { display: none; }
.twg-foot {
padding: 9px 13px;
border-top: 1px solid rgba(255, 255, 255, 0.07);
display: flex;
align-items: center;
justify-content: space-between;
gap: 10px;
}
.twg-foot-note { font-size: 10.5px; color: rgba(255, 255, 255, 0.28); }
.twg-link {
background: none;
border: none;
padding: 0;
font: 600 11px var(--font-body, 'Inter', system-ui, sans-serif);
color: rgba(255, 255, 255, 0.35);
cursor: pointer;
text-decoration: underline;
text-underline-offset: 2px;
}
.twg-link:hover { color: rgba(255, 255, 255, 0.65); }
.twg-link:focus-visible { outline: 2px solid var(--accent, #fff); outline-offset: 2px; border-radius: 3px; }
/* All-core-complete celebratory header tint. */
.twg-panel.is-complete .twg-title::after {
content: ' ✓';
color: var(--success, #4ade80);
}
/* ── Welcome modal (first run) ─────────────────────────────────────────────── */
.twg-modal-overlay {
position: fixed;
inset: 0;
z-index: 2147483600; /* above all corner widgets */
display: grid;
place-items: center;
padding: 20px;
background: rgba(5, 6, 10, 0.78);
backdrop-filter: blur(8px);
-webkit-backdrop-filter: blur(8px);
animation: twg-fade 0.2s ease;
}
.twg-modal-overlay[hidden] { display: none; }
@keyframes twg-fade { from { opacity: 0; } to { opacity: 1; } }
.twg-modal {
width: 440px;
max-width: 100%;
border: 1px solid rgba(255, 255, 255, 0.11);
border-radius: 20px;
background: rgba(14, 15, 21, 0.99);
box-shadow: 0 32px 80px rgba(0, 0, 0, 0.65), 0 1px 0 rgba(255, 255, 255, 0.06) inset;
color: rgba(255, 255, 255, 0.85);
overflow: hidden;
animation: twg-pop 0.28s cubic-bezier(0.16, 1, 0.3, 1);
}
.twg-modal-art {
position: relative;
height: 128px;
display: grid;
place-items: center;
background:
radial-gradient(120% 140% at 50% 0%, rgba(255, 255, 255, 0.08), transparent 60%),
linear-gradient(180deg, rgba(255, 255, 255, 0.03), transparent);
border-bottom: 1px solid rgba(255, 255, 255, 0.06);
overflow: hidden;
}
.twg-modal-art-glyph {
font-size: 44px;
filter: drop-shadow(0 6px 20px rgba(0, 0, 0, 0.4));
animation: twg-float 4s ease-in-out infinite;
}
@keyframes twg-float {
0%, 100% { transform: translateY(0); }
50% { transform: translateY(-6px); }
}
.twg-modal-body { padding: 22px 24px 20px; }
.twg-modal-eyebrow {
margin: 0 0 8px;
font-size: 10.5px;
font-weight: 700;
letter-spacing: 0.10em;
text-transform: uppercase;
color: rgba(255, 255, 255, 0.30);
}
.twg-modal-title {
margin: 0 0 10px;
font: 700 23px/1.15 var(--font-display, 'Space Grotesk', 'Inter', sans-serif);
letter-spacing: -0.02em;
color: rgba(255, 255, 255, 0.96);
}
.twg-modal-lede {
margin: 0 0 18px;
font-size: 14px;
line-height: 1.5;
color: rgba(255, 255, 255, 0.55);
}
.twg-modal-steps {
display: flex;
gap: 7px;
margin: 0 0 22px;
padding: 0;
list-style: none;
}
.twg-modal-steps li {
flex: 1;
display: flex;
flex-direction: column;
gap: 5px;
padding: 10px 8px;
border: 1px solid rgba(255, 255, 255, 0.08);
border-radius: 11px;
background: rgba(255, 255, 255, 0.02);
font-size: 11px;
font-weight: 600;
color: rgba(255, 255, 255, 0.65);
text-align: center;
}
.twg-modal-steps li span { font-size: 17px; }
.twg-modal-actions { display: flex; gap: 10px; align-items: center; }
.twg-btn {
display: inline-flex;
align-items: center;
justify-content: center;
gap: 7px;
height: 44px;
padding: 0 20px;
border-radius: 12px;
font: 600 13.5px var(--font-body, 'Inter', system-ui, sans-serif);
cursor: pointer;
text-decoration: none;
border: 1px solid transparent;
transition: transform var(--duration-fast) var(--ease-standard), background var(--duration-fast) var(--ease-standard), border-color var(--duration-fast) var(--ease-standard), opacity var(--duration-fast) var(--ease-standard);
}
.twg-btn:focus-visible { outline: 2px solid var(--accent, #fff); outline-offset: 2px; }
.twg-btn-primary {
flex: 1;
background: rgba(255, 255, 255, 0.95);
color: #0c0c0c;
box-shadow: 0 4px 20px rgba(0, 0, 0, 0.3);
}
.twg-btn-primary:hover { transform: translateY(-1px); opacity: 0.90; }
.twg-btn-ghost {
background: transparent;
color: rgba(255, 255, 255, 0.40);
border-color: rgba(255, 255, 255, 0.10);
}
.twg-btn-ghost:hover { color: rgba(255, 255, 255, 0.72); border-color: rgba(255, 255, 255, 0.24); }
.twg-modal-fineprint {
margin: 14px 0 0;
font-size: 11px;
color: rgba(255, 255, 255, 0.28);
text-align: center;
}
@media (max-width: 480px) {
.twg-root { right: 12px; bottom: 12px; }
/* Anchored to the viewport, not to the pill. The pill lives in the shared
corner stack, and that stack steps sideways into a narrow column when the
Walk Companion claims the corner: a 358px panel hung on the right edge of
a 171px column ran a third of its width off the left of the screen. The
offset mirrors the stack's own (inset + reserve + measured page dock) plus
the pill's height, so the panel opens directly above the pill wherever the
stack currently sits. */
.twg-panel {
position: fixed;
left: 12px;
right: 12px;
width: auto;
max-width: none;
/* --tws-corner-claim, not --tws-corner-reserve: when a corner widget is
narrow enough for the stack to step beside it, the pill moves sideways
but a full-width panel still has to clear it. */
bottom: calc(66px + var(--tws-corner-claim, 0px) + var(--tws-corner-dock, 0px));
}
.twg-modal-title { font-size: 20px; }
.twg-modal-steps { flex-direction: row; }
}
/* Touch: the floating onboarding pill is a primary CTA — give it a full
44px hit height (WCAG 2.5.8) without changing the desktop mouse size. */
@media (hover: none) and (pointer: coarse) {
.twg-pill { height: 44px; padding: 0 16px 0 12px; }
}
@media (prefers-reduced-motion: reduce) {
.twg-panel, .twg-modal, .twg-modal-overlay, .twg-modal-art-glyph { animation: none !important; }
.twg-bar-fill, .twg-pill, .twg-step, .twg-step-arrow, .twg-btn { transition: none !important; }
}