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
Feature 16: invite flow (deep link, QR, OG card) for the event
Everyone at the event arrives through one link, and everyone who has fun should be able to pull one more person in. Make inviting effortless from inside the world, and make the link unfurl beautifully everywhere it is pasted.
Where the code lives
- Deep-link contract:
coinWorldUrl()insrc/fits-lib.js(tested intests/fits-lib.test.js); canonical URL emission insrc/game/coincommunities.js(history.replaceStateinenter(), which keeps exactlycoin,name,symbol,image,tierfor a holders world, andui; any link that arrives short of a full identity, including a complete share link since it carries no market cap, resolves name, symbol, image and market cap through_fetchCoinIdentitybefore the rewrite, so the canonical link is always complete) - OG image for /play links:
api/play-og.js(GET-only since the fleet hardening pass; any other verb is refused before the satori render). Its coin lookup is a self-call on the configured origin fromapi/_lib/self-origin.js, never the request'shostorx-forwarded-host; outside production a loopback host is honored, so hitting the endpoint onnpm run devrenders against the local server. House OG patterns:api/page-og.js,api/og-leaderboard.js - HUD mount + share precedent:
src/game/coincommunities-ui.jsand the build-share sheet. Do not confuse this with the friend invites insrc/game/friends-panel.js, which are a social-graph request, not a world link - QR:
qrcodeis already a dependency (src/wallet-deposit.jsandsrc/marketplace.jsrender with it); use it, no new encoder
What to build
- Invite button. A HUD control (and lobby-card action) opening a small invite sheet: the canonical world link with copy button, a live QR code of that link (event hosts will show phones to each other), and
navigator.sharewhere available. The link always carriescoin,name,symbol,imageso the destination renders identity instantly, before any API round-trip. - OG card truth. Paste-test the canonical $THREE URL: the unfurl must show the coin image, name, symbol, and a line that sells the world. If
api/play-og.jsrenders stale or generic art, fix it: it should composite the real coin image (via the/api/imgproxy, with a designed fallback when IPFS fails) and live-ish facts if cheap (online count is a nice touch only if it does not slow the card). - Arrival continuity. An invitee landing from the link skips straight into the flow a first-timer needs: intro suppressed (a
coinparam already does this), onboarding shown once, and if Feature 14 landed the concierge greets them. Verify the whole arrival path on a fresh profile. - Event framing. During the event window (
public/event.json), the invite sheet leads with the event name and countdown, so the share reads as an invitation to a happening, not just a link.
Verify
npm run dev: invite sheet on desktop and emulated mobile; QR scans from a real phone camera to the right URL; copy toast; share sheet on mobile.- OG card rendered locally (hit the endpoint directly) and correct for the $THREE canonical URL, including the IPFS-failure fallback.
npm testgreen.
Report format
Files shipped, any dependency added (name, weekly downloads, license, why), a rendered OG card sample path, and the data/changelog.json entry.