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
<!doctype html>
<html lang="en">
<head>
<script>/* three.ws theme boot — no-flash */(function(){try{var m=localStorage.getItem('twx_theme');var l=m==='auto'?(window.matchMedia&&window.matchMedia('(prefers-color-scheme: light)').matches):m==='light';document.documentElement.setAttribute('data-theme',l?'light':'dark');}catch(e){document.documentElement.setAttribute('data-theme','dark');}})();</script>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0, viewport-fit=cover" />
<title data-i18n="walk_analytics.meta_title">Walk Analytics · three.ws</title>
<meta name="description" content="Analytics for your embedded walking avatars — sessions, time spent, distance walked, conversion events, and top embed locations. Your private creator dashboard." data-i18n-attr="content:walk_analytics.meta_description"/>
<link rel="canonical" href="https://three.ws/walk-analytics" />
<meta name="robots" content="noindex" />
<link rel="icon" href="/favicon.ico" sizes="any" />
<link rel="icon" type="image/svg+xml" href="/favicon.svg" />
<link rel="apple-touch-icon" href="/apple-touch-icon.png" />
<link rel="manifest" href="/manifest.webmanifest" />
<link rel="stylesheet" href="/style.css" />
<link rel="stylesheet" href="/nav.css" />
<link rel="stylesheet" href="/footer.css" />
<meta property="og:type" content="website" />
<meta property="og:site_name" content="three.ws" />
<meta property="og:title" content="Walk Analytics · three.ws" data-i18n-attr="content:walk_analytics.meta_og_title"/>
<meta property="og:description" content="Sessions, time, distance, conversions and top embed locations for your walking avatars." data-i18n-attr="content:walk_analytics.meta_og_description"/>
<meta name="theme-color" content="#0a0a0a" />
<style>
.wa-shell { max-width: 1080px; margin: 0 auto; padding: var(--space-lg) var(--space-md) var(--space-2xl); }
.wa-hero { padding: var(--space-xl) 0 var(--space-md); }
.wa-title { font: var(--weight-bold) var(--text-2xl)/1.05 var(--font-display); color: var(--color-text-bright); margin: 0 0 var(--space-sm); letter-spacing: -0.02em; }
.wa-sub { font: var(--weight-regular) var(--text-base)/var(--leading-normal) var(--font-body); color: var(--color-text-dim); margin: 0; max-width: 62ch; }
.wa-controls { display: flex; flex-wrap: wrap; gap: var(--space-sm); align-items: flex-end; margin: var(--space-lg) 0 var(--space-md); }
.wa-field { display: flex; flex-direction: column; gap: var(--space-3xs); }
.wa-field label { font: var(--weight-semibold) var(--text-2xs)/1 var(--font-mono); text-transform: uppercase; letter-spacing: 0.06em; color: var(--color-text-faint); }
.wa-input, .wa-select {
appearance: none; background: var(--surface-1); color: var(--color-text);
border: 1px solid var(--color-border); border-radius: var(--radius-md);
padding: var(--space-xs) var(--space-sm); font: var(--weight-medium) var(--text-md)/1.2 var(--font-body);
min-height: 38px; transition: border-color var(--duration-fast) var(--ease-standard);
}
.wa-input:hover, .wa-select:hover { border-color: var(--color-border-strong); }
.wa-input:focus-visible, .wa-select:focus-visible { outline: var(--focus-ring-width) solid var(--focus-ring-color); outline-offset: var(--focus-ring-offset); }
.wa-select { min-width: 200px; }
.wa-cards { display: grid; grid-template-columns: repeat(4, 1fr); gap: var(--space-sm); margin: var(--space-md) 0; }
.wa-card { background: var(--surface-1); border: 1px solid var(--color-border); border-radius: var(--radius-lg); padding: var(--space-md); }
.wa-card-label { font: var(--weight-semibold) var(--text-2xs)/1 var(--font-mono); text-transform: uppercase; letter-spacing: 0.06em; color: var(--color-text-faint); margin: 0 0 var(--space-xs); }
.wa-card-value { font: var(--weight-bold) var(--text-xl)/1 var(--font-display); color: var(--color-text-bright); }
.wa-panel { background: var(--surface-1); border: 1px solid var(--color-border); border-radius: var(--radius-lg); padding: var(--space-md); margin: var(--space-md) 0; }
.wa-panel-title { font: var(--weight-semibold) var(--text-lg)/1.2 var(--font-display); color: var(--color-text-bright); margin: 0 0 var(--space-sm); }
.wa-chart-wrap { position: relative; width: 100%; }
.wa-chart { width: 100%; height: auto; display: block; overflow: visible; }
.wa-chart-legend { display: flex; gap: var(--space-md); margin-top: var(--space-sm); flex-wrap: wrap; }
.wa-legend-item { display: inline-flex; align-items: center; gap: var(--space-2xs); font: var(--weight-medium) var(--text-sm)/1 var(--font-body); color: var(--color-text-dim); cursor: pointer; user-select: none; }
.wa-legend-swatch { width: 10px; height: 10px; border-radius: 3px; flex: none; }
.wa-legend-item.is-off { opacity: 0.4; }
.wa-table { width: 100%; border-collapse: collapse; }
.wa-table th, .wa-table td { text-align: left; padding: var(--space-sm); border-bottom: 1px solid var(--color-border); font: var(--weight-regular) var(--text-md)/1.3 var(--font-body); color: var(--color-text); }
.wa-table th { font: var(--weight-semibold) var(--text-2xs)/1 var(--font-mono); text-transform: uppercase; letter-spacing: 0.06em; color: var(--color-text-faint); }
.wa-table td.num, .wa-table th.num { text-align: right; font-family: var(--font-mono); }
.wa-table tr:last-child td { border-bottom: 0; }
.wa-origin { font-family: var(--font-mono); color: var(--color-text-bright); }
.wa-rate { color: var(--color-success); font-weight: var(--weight-semibold); }
.wa-state { padding: var(--space-2xl) var(--space-md); text-align: center; }
.wa-state-title { font: var(--weight-semibold) var(--text-lg)/1.2 var(--font-display); color: var(--color-text-bright); margin: 0 0 var(--space-xs); }
.wa-state-msg { font: var(--weight-regular) var(--text-md)/var(--leading-normal) var(--font-body); color: var(--color-text-dim); margin: 0 auto var(--space-md); max-width: 48ch; }
.wa-cta { display: inline-flex; align-items: center; gap: var(--space-xs); padding: var(--space-sm) var(--space-lg); border-radius: var(--radius-md); background: var(--accent); color: var(--bg-0); font: var(--weight-semibold) var(--text-md)/1 var(--font-body); text-decoration: none; transition: opacity var(--duration-fast) var(--ease-standard); border: 0; cursor: pointer; }
.wa-cta:hover { opacity: 0.85; }
.wa-cta.ghost { background: var(--surface-2); color: var(--color-text); border: 1px solid var(--color-border); }
.wa-empty { padding: var(--space-xl) var(--space-md); text-align: center; color: var(--color-text-dim); font: var(--weight-regular) var(--text-md)/1.4 var(--font-body); }
.wa-skel { height: 14px; border-radius: var(--radius-sm); background: linear-gradient(90deg, var(--surface-2) 25%, var(--surface-3) 37%, var(--surface-2) 63%); background-size: 400% 100%; animation: wa-shimmer 1.4s ease infinite; }
@keyframes wa-shimmer { 0% { background-position: 100% 0; } 100% { background-position: -100% 0; } }
@media (prefers-reduced-motion: reduce) { .wa-skel { animation: none; } }
[hidden] { display: none !important; }
@media (max-width: 820px) { .wa-cards { grid-template-columns: repeat(2, 1fr); } }
@media (max-width: 480px) { .wa-cards { grid-template-columns: 1fr; } .wa-select { min-width: 0; width: 100%; } .wa-title { font-size: var(--text-xl); } }
</style>
</head>
<body>
<header><div id="nav-container"></div></header>
<script src="/nav.js"></script>
<main class="wa-shell" aria-labelledby="wa-title">
<section class="wa-hero">
<h1 id="wa-title" class="wa-title" data-i18n="walk_analytics.walk_analytics">Walk Analytics</h1>
<p class="wa-sub" data-i18n="walk_analytics.how_your_embedded_walking_avatars_are_perfor">How your embedded walking avatars are performing — sessions, time spent, distance walked, conversion events, and where they're running. Private to you, the creator.</p>
</section>
<!-- Auth / ownership states swap in here -->
<div id="wa-gate" hidden></div>
<!-- Dashboard (shown when authed + owns at least one avatar) -->
<div id="wa-dash" hidden>
<section class="wa-controls" aria-label="Filters">
<div class="wa-field">
<label for="wa-avatar" data-i18n="walk_analytics.avatar">Avatar</label>
<select id="wa-avatar" class="wa-select" aria-label="Choose an avatar"></select>
</div>
<div class="wa-field">
<label for="wa-from" data-i18n="walk_analytics.from">From</label>
<input type="date" id="wa-from" class="wa-input" aria-label="From date" />
</div>
<div class="wa-field">
<label for="wa-to" data-i18n="walk_analytics.to">To</label>
<input type="date" id="wa-to" class="wa-input" aria-label="To date" />
</div>
<button type="button" id="wa-apply" class="wa-cta ghost" data-i18n="walk_analytics.apply">Apply</button>
</section>
<section class="wa-cards" id="wa-cards" aria-label="Summary">
<div class="wa-card"><p class="wa-card-label" data-i18n="walk_analytics.sessions">Sessions</p><div class="wa-card-value" id="wa-c-sessions">—</div></div>
<div class="wa-card"><p class="wa-card-label" data-i18n="walk_analytics.avg_duration">Avg duration</p><div class="wa-card-value" id="wa-c-duration">—</div></div>
<div class="wa-card"><p class="wa-card-label" data-i18n="walk_analytics.distance_walked">Distance walked</p><div class="wa-card-value" id="wa-c-distance">—</div></div>
<div class="wa-card"><p class="wa-card-label" data-i18n="walk_analytics.unique_sites">Unique sites</p><div class="wa-card-value" id="wa-c-origins">—</div></div>
</section>
<section class="wa-panel" aria-label="Sessions over time">
<h2 class="wa-panel-title" data-i18n="walk_analytics.over_time">Over time</h2>
<div class="wa-chart-wrap" id="wa-chart-wrap"></div>
<div class="wa-chart-legend" id="wa-legend"></div>
</section>
<section class="wa-panel" aria-label="Top embed locations">
<h2 class="wa-panel-title" data-i18n="walk_analytics.top_embed_locations">Top embed locations</h2>
<div id="wa-origins"></div>
</section>
<section class="wa-panel" aria-label="Conversion events">
<h2 class="wa-panel-title" data-i18n="walk_analytics.events">Events</h2>
<p class="wa-sub" style="margin:0 0 12px;font-size:var(--text-sm)" data-i18n-html="walk_analytics.fire_events_from_your_embed_with_conversion">Fire events from your embed with <code style="font-family:var(--font-mono)">window.ThreeWalkAvatar.track('subscribe', { value: 9 })</code>. Conversion rate is events ÷ sessions.</p>
<div id="wa-events"></div>
</section>
</div>
</main>
<script src="/brand.js" defer></script>
<div id="footer-container"></div>
<script src="/footer.js"></script>
<script type="module">
const gate = document.getElementById('wa-gate');
const dash = document.getElementById('wa-dash');
const avatarSel = document.getElementById('wa-avatar');
const fromEl = document.getElementById('wa-from');
const toEl = document.getElementById('wa-to');
const applyEl = document.getElementById('wa-apply');
const esc = (s) => String(s).replace(/[<>&"']/g, (c) => ({ '<': '<', '>': '>', '&': '&', '"': '"', "'": ''' }[c]));
const isoDate = (d) => d.toISOString().slice(0, 10);
function showGate(html) { gate.innerHTML = html; gate.hidden = false; dash.hidden = true; }
// Error states are rendered from strings, so their buttons declare what
// they do with data-action and this one delegated listener runs it. The
// site CSP allows inline <script> by hash only, so an onclick attribute
// on generated markup would never fire.
document.addEventListener('click', (event) => {
const action = event.target.closest('[data-action]')?.dataset.action;
if (action === 'reload') location.reload();
else if (action === 'retry') loadAnalytics();
});
function fmtDistance(m) { return m >= 1000 ? (m / 1000).toFixed(2) + ' km' : Math.round(m) + ' m'; }
function fmtDuration(s) {
s = Math.round(s);
if (s >= 3600) return (s / 3600).toFixed(1) + ' h';
if (s >= 60) return Math.round(s / 60) + ' min ' + (s % 60) + ' s';
return s + ' s';
}
async function boot() {
let mine;
try {
const res = await fetch('/api/avatars/mine?limit=100', { credentials: 'include' });
if (res.status === 401) {
return showGate(`<div class="wa-state"><p class="wa-state-title">Sign in to view your analytics</p><p class="wa-state-msg">Walk analytics are private to the creator who owns the avatar. Sign in to see how your embedded walking avatars are performing.</p><a class="wa-cta" href="/login?next=/walk-analytics">Sign in →</a></div>`);
}
if (!res.ok) throw new Error('HTTP ' + res.status);
mine = await res.json();
} catch (err) {
return showGate(`<div class="wa-state"><p class="wa-state-title">Couldn't load your avatars</p><p class="wa-state-msg">${esc(err.message || 'Something went wrong.')}</p><button class="wa-cta" type="button" data-action="reload">Retry</button></div>`);
}
const avatars = (mine && mine.avatars) || [];
if (!avatars.length) {
return showGate(`<div class="wa-state"><p class="wa-state-title">No avatars yet</p><p class="wa-state-msg">Create a walking avatar and embed it on your site. Once it starts walking, your sessions, distance, and conversion events will show up here.</p><a class="wa-cta" href="/create">Create an avatar →</a> <a class="wa-cta ghost" href="/walk-embed" style="margin-left:8px">Get embed code</a></div>`);
}
gate.hidden = true;
dash.hidden = false;
avatarSel.innerHTML = avatars.map((a) => `<option value="${esc(a.id)}">${esc(a.name || a.slug || 'Untitled')}</option>`).join('');
const today = new Date();
const start = new Date(); start.setUTCDate(start.getUTCDate() - 29);
fromEl.value = isoDate(start);
toEl.value = isoDate(today);
toEl.max = isoDate(today);
fromEl.max = isoDate(today);
// Preselect avatar from ?avatarId if present.
const qpAvatar = new URLSearchParams(location.search).get('avatarId');
if (qpAvatar && avatars.some((a) => a.id === qpAvatar)) avatarSel.value = qpAvatar;
avatarSel.addEventListener('change', loadAnalytics);
applyEl.addEventListener('click', loadAnalytics);
loadAnalytics();
}
function cardSkeletons() {
['wa-c-sessions', 'wa-c-duration', 'wa-c-distance', 'wa-c-origins'].forEach((id) => {
document.getElementById(id).innerHTML = '<span class="wa-skel" style="display:inline-block;width:60px"></span>';
});
document.getElementById('wa-chart-wrap').innerHTML = '<div class="wa-skel" style="height:220px;border-radius:10px"></div>';
document.getElementById('wa-origins').innerHTML = '<div class="wa-skel" style="height:80px;border-radius:10px"></div>';
document.getElementById('wa-events').innerHTML = '<div class="wa-skel" style="height:80px;border-radius:10px"></div>';
}
async function loadAnalytics() {
const avatarId = avatarSel.value;
if (!avatarId) return;
cardSkeletons();
const params = new URLSearchParams({ avatarId, from: fromEl.value, to: toEl.value });
let data;
try {
const res = await fetch('/api/walk/analytics?' + params.toString(), { credentials: 'include' });
if (res.status === 403) {
return showGate(`<div class="wa-state"><p class="wa-state-title">Not your avatar</p><p class="wa-state-msg">You can only view analytics for avatars you own.</p><a class="wa-cta" href="/walk-analytics">Back to your avatars</a></div>`);
}
if (!res.ok) throw new Error('HTTP ' + res.status);
data = await res.json();
} catch (err) {
document.getElementById('wa-chart-wrap').innerHTML = `<div class="wa-empty">Couldn't load analytics: ${esc(err.message || 'error')}. <button class="wa-cta ghost" type="button" style="margin-left:8px" data-action="retry">Retry</button></div>`;
return;
}
document.getElementById('wa-c-sessions').textContent = data.totalSessions.toLocaleString();
document.getElementById('wa-c-duration').textContent = data.totalSessions ? fmtDuration(data.avgDurationSec) : '—';
document.getElementById('wa-c-distance').textContent = fmtDistance(data.totalDistance);
document.getElementById('wa-c-origins').textContent = data.uniqueOrigins.toLocaleString();
renderChart(data.timeSeries || []);
renderOrigins(data.topOrigins || []);
renderEvents(data.events || [], data.totalSessions);
}
// ── Hand-rolled SVG line/area chart (sessions + distance) ──────────────
const chartState = { sessions: true, distance: true };
let lastSeries = [];
function renderChart(series) {
lastSeries = series;
const wrap = document.getElementById('wa-chart-wrap');
const legend = document.getElementById('wa-legend');
const hasData = series.some((d) => d.sessions > 0 || d.distanceMeters > 0);
if (!series.length || !hasData) {
wrap.innerHTML = '<div class="wa-empty">No walks recorded in this range yet. Embed your avatar and check back — sessions appear within ~60 seconds of a visit.</div>';
legend.innerHTML = '';
return;
}
const W = 920, H = 240, padL = 44, padR = 16, padT = 16, padB = 28;
const innerW = W - padL - padR, innerH = H - padT - padB;
const n = series.length;
const xAt = (i) => padL + (n === 1 ? innerW / 2 : (i / (n - 1)) * innerW);
const maxS = Math.max(1, ...series.map((d) => d.sessions));
const maxD = Math.max(1, ...series.map((d) => d.distanceMeters));
const ySessions = (v) => padT + innerH - (v / maxS) * innerH;
const yDistance = (v) => padT + innerH - (v / maxD) * innerH;
const colSessions = getComputedStyle(document.documentElement).getPropertyValue('--accent').trim() || '#fff';
const colDistance = '#8b5cf6';
function path(yFn, key) {
return series.map((d, i) => `${i === 0 ? 'M' : 'L'}${xAt(i).toFixed(1)},${yFn(d[key]).toFixed(1)}`).join(' ');
}
function area(yFn, key) {
const top = series.map((d, i) => `${i === 0 ? 'M' : 'L'}${xAt(i).toFixed(1)},${yFn(d[key]).toFixed(1)}`).join(' ');
return `${top} L${xAt(n - 1).toFixed(1)},${(padT + innerH).toFixed(1)} L${xAt(0).toFixed(1)},${(padT + innerH).toFixed(1)} Z`;
}
// Gridlines + y labels (sessions axis).
let grid = '';
for (let g = 0; g <= 4; g++) {
const y = padT + (g / 4) * innerH;
const val = Math.round(maxS * (1 - g / 4));
grid += `<line x1="${padL}" y1="${y.toFixed(1)}" x2="${W - padR}" y2="${y.toFixed(1)}" stroke="var(--color-border)" stroke-width="1" />`;
grid += `<text x="${padL - 8}" y="${(y + 4).toFixed(1)}" text-anchor="end" font-size="10" fill="var(--color-text-faint)" font-family="var(--font-mono)">${val}</text>`;
}
// x labels (first, middle, last).
let xlabels = '';
[0, Math.floor((n - 1) / 2), n - 1].forEach((i) => {
if (i < 0 || i >= n) return;
const lbl = series[i].date.slice(5); // MM-DD
xlabels += `<text x="${xAt(i).toFixed(1)}" y="${H - 8}" text-anchor="middle" font-size="10" fill="var(--color-text-faint)" font-family="var(--font-mono)">${lbl}</text>`;
});
const dots = series.map((d, i) => chartState.sessions && d.sessions > 0
? `<circle cx="${xAt(i).toFixed(1)}" cy="${ySessions(d.sessions).toFixed(1)}" r="2.5" fill="${colSessions}"><title>${esc(d.date)}: ${d.sessions} sessions, ${fmtDistance(d.distanceMeters)}</title></circle>`
: '').join('');
wrap.innerHTML = `
<svg class="wa-chart" viewBox="0 0 ${W} ${H}" preserveAspectRatio="xMidYMid meet" role="img" aria-label="Sessions and distance over time">
${grid}${xlabels}
${chartState.distance ? `<path d="${area(yDistance, 'distanceMeters')}" fill="${colDistance}" fill-opacity="0.10" />` : ''}
${chartState.distance ? `<path d="${path(yDistance, 'distanceMeters')}" fill="none" stroke="${colDistance}" stroke-width="2" stroke-linejoin="round" />` : ''}
${chartState.sessions ? `<path d="${path(ySessions, 'sessions')}" fill="none" stroke="${colSessions}" stroke-width="2" stroke-linejoin="round" />` : ''}
${dots}
</svg>`;
legend.innerHTML = `
<span class="wa-legend-item ${chartState.sessions ? '' : 'is-off'}" data-k="sessions" role="button" tabindex="0"><span class="wa-legend-swatch" style="background:${colSessions}"></span>Sessions</span>
<span class="wa-legend-item ${chartState.distance ? '' : 'is-off'}" data-k="distance" role="button" tabindex="0"><span class="wa-legend-swatch" style="background:${colDistance}"></span>Distance</span>`;
legend.querySelectorAll('.wa-legend-item').forEach((el) => {
const toggle = () => { const k = el.dataset.k; chartState[k] = !chartState[k]; renderChart(lastSeries); };
el.addEventListener('click', toggle);
el.addEventListener('keydown', (e) => { if (e.key === 'Enter' || e.key === ' ') { e.preventDefault(); toggle(); } });
});
}
function renderOrigins(origins) {
const el = document.getElementById('wa-origins');
if (!origins.length) { el.innerHTML = '<div class="wa-empty">No embed origins recorded yet. When your avatar runs inside an iframe on another site, that host appears here.</div>'; return; }
el.innerHTML = `<table class="wa-table"><thead><tr><th>Origin</th><th class="num">Sessions</th><th class="num">Distance</th></tr></thead><tbody>${origins.map((o) => `<tr><td class="wa-origin">${esc(o.origin)}</td><td class="num">${o.sessions.toLocaleString()}</td><td class="num">${fmtDistance(o.distanceMeters)}</td></tr>`).join('')}</tbody></table>`;
}
function renderEvents(events, sessions) {
const el = document.getElementById('wa-events');
if (!events.length) { el.innerHTML = '<div class="wa-empty">No conversion events tracked yet. Call <code style="font-family:var(--font-mono)">ThreeWalkAvatar.track(...)</code> from your embed to measure subscribes, purchases, plays, and more.</div>'; return; }
el.innerHTML = `<table class="wa-table"><thead><tr><th>Event</th><th class="num">Count</th><th class="num">Conversion</th></tr></thead><tbody>${events.map((e) => `<tr><td>${esc(e.name)}</td><td class="num">${e.count.toLocaleString()}</td><td class="num wa-rate">${sessions ? e.conversionRate.toFixed(2) + '%' : '—'}</td></tr>`).join('')}</tbody></table>`;
}
boot();
</script>
<!-- Runtime i18n: detects locale, swaps annotated copy, mounts <lang-switcher>. -->
<script type="module" src="/i18n.js"></script>
</body>
</html>