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.

21.0 KB
Raw Blame
<!doctype html>
<html lang="en">
	<head>
		<meta charset="utf-8" />
		<meta http-equiv="X-UA-Compatible" content="IE=edge" />
		<title data-i18n="studio_index.meta_title">Widget Studio · three.ws</title>
		<meta name="viewport" content="width=device-width, initial-scale=1.0, viewport-fit=cover" />
		<meta
			name="description"
			content="Pick any three.ws avatar, choose a widget type, set brand colors and environment, and copy a one-line embed snippet for your site."
		 data-i18n-attr="content:studio_index.meta_description"/>
		<meta name="theme-color" content="#0a0a0a" />
		<meta name="robots" content="noindex" />
		<link rel="shortcut icon" href="/favicon.ico" />
		<link rel="stylesheet" href="/fonts/fonts.css" />
		<link rel="stylesheet" href="/studio/studio.css?v=4" />
		<link rel="stylesheet" href="/mobile.css" />
		<style>
			/* Critical layout — guarantees the 3-column grid renders even if
			   studio.css is held by a stale SW cache. */
			html, body { margin: 0; padding: 0; }
			body.studio-body {
				background: #0a0a0a;
				color: #eee;
				font-family: 'Inter', system-ui, -apple-system, sans-serif;
				font-size: 14px;
				line-height: 1.45;
				min-height: 100vh;
				overflow-x: hidden;
			}
			.studio-header {
				position: sticky; top: 0; z-index: 50;
				display: flex; align-items: center; justify-content: space-between;
				gap: 1rem; height: 60px; padding: 0 1.25rem;
				background: rgba(10,10,15,0.85);
				backdrop-filter: blur(12px);
				border-bottom: 1px solid rgba(255,255,255,0.08);
			}
			.studio-header h1 { display: flex; align-items: center; gap: 0.55rem; margin: 0; font-size: 1rem; font-weight: 600; }
			.studio-header nav { display: flex; align-items: center; gap: 0.25rem; flex-wrap: wrap; }
			.studio-layout {
				display: grid;
				grid-template-columns: 320px minmax(0, 1fr) 380px;
				gap: 1rem; padding: 1rem;
				max-width: 1600px; margin: 0 auto;
				align-items: start;
			}
			.studio-col-left, .studio-col-mid, .studio-col-right {
				display: flex; flex-direction: column; gap: 1rem; min-width: 0;
			}
			.studio-col-mid { position: sticky; top: 76px; }
			@media (max-width: 1280px) {
				.studio-layout { grid-template-columns: 280px minmax(0, 1fr) 340px; }
			}
			@media (max-width: 1100px) {
				.studio-layout { grid-template-columns: 1fr; }
				.studio-col-mid { position: static; order: -1; }
			}
			@media (max-width: 640px) {
				.studio-layout { padding: 0.6rem; gap: 0.6rem; }
				.avatar-list { grid-template-columns: repeat(3, minmax(0, 1fr)); }
			}
			@media (max-width: 400px) {
				.avatar-list { grid-template-columns: repeat(2, minmax(0, 1fr)); }
			}
			.panel {
				background: #151515;
				border: 1px solid #2b2b2b;
				border-radius: 14px;
				padding: 1.1rem 1.1rem 1.2rem;
			}
			.avatar-list { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 0.55rem; }
			.type-grid { display: grid; grid-template-columns: 1fr; gap: 0.5rem; }
		</style>
		<script type="importmap">
		{
			"imports": {
				"@solana/web3.js": "https://esm.sh/@solana/[email protected]?bundle",
				"@solana/spl-token": "https://esm.sh/@solana/[email protected]?bundle&deps=@solana/[email protected]"
			}
		}
		</script>
	
	<link rel="canonical" href="https://three.ws/studio">
	<meta property="og:type" content="website">
	<meta property="og:site_name" content="three.ws">
	<meta property="og:title" content="Widget Studio · three.ws" data-i18n-attr="content:studio_index.meta_og_title">
	<meta property="og:description" content="Pick an avatar, configure embed options, copy a one-line snippet for your site." data-i18n-attr="content:studio_index.meta_og_description">
	<meta property="og:url" content="https://three.ws/studio">
	<meta property="og:image" content="https://three.ws/api/page-og?s=build&amp;t=Widget+Studio&amp;d=Build+an+embeddable+3D+widget%3A+pick+an+avatar+%28or+your+own+model+URL%29%2C+pick+a+widget+type%2C+tune+it+live%2C+and+copy+the+snippet.+No+account+needed+for+the&amp;p=%2Fstudio">
	<meta property="og:image:width" content="1200">
	<meta property="og:image:height" content="630">
	<meta name="twitter:card" content="summary_large_image">
	<meta name="twitter:title" content="Widget Studio · three.ws" data-i18n-attr="content:studio_index.meta_twitter_title">
	<meta name="twitter:description" content="Pick an avatar, configure embed options, copy a one-line snippet for your site." data-i18n-attr="content:studio_index.meta_twitter_description">
	<meta name="twitter:image" content="https://three.ws/api/page-og?s=build&amp;t=Widget+Studio&amp;d=Build+an+embeddable+3D+widget%3A+pick+an+avatar+%28or+your+own+model+URL%29%2C+pick+a+widget+type%2C+tune+it+live%2C+and+copy+the+snippet.+No+account+needed+for+the&amp;p=%2Fstudio">
	<script type="application/ld+json">{"@context":"https://schema.org","@type":"WebPage","name":"Widget Studio","description":"Pick an avatar, configure embed options, copy a one-line snippet for your site.","url":"https://three.ws/studio","isPartOf":{"@type":"WebSite","name":"three.ws","url":"https://three.ws"}}</script>

	<meta property="og:locale" content="en_US">
	<meta property="og:image:alt" content="Widget Studio — three.ws">
	<meta name="twitter:site" content="@trythreews">
</head>
	<body class="studio-body">
		<header class="studio-header">
			<h1 data-i18n-html="studio_index.studio">
				<a href="/"><img src="/three.svg" alt="three.ws" class="wordmark-logo" /></a
				><span class="studio-tag">Studio</span>
			</h1>
			<nav>
				<a href="/app" data-i18n="studio_index.viewer">Viewer</a>
				<a href="/create" data-i18n="studio_index.create">Create</a>
				<a href="/discover" data-i18n="studio_index.discover">Discover</a>
				<a href="/features" data-i18n="studio_index.features">Features</a>
				<a href="/widgets" data-i18n="studio_index.widgets">Widgets</a>
				<a href="/studio" aria-current="page" data-i18n="studio_index.studio_2">Studio</a>
				<a href="/docs" data-i18n="studio_index.docs">Docs</a>
				<div id="user-menu" class="user-menu" data-state="loading"></div>
			</nav>
		</header>

		<main class="studio-layout" id="studio-layout" hidden>
			<section class="studio-col-left" aria-label="Pick avatar and widget type">
				<div class="panel">
					<h2 data-tooltip="The 3D model your widget will display. We've pre-loaded a demo agent so you can try the studio right away — sign in to use your own." data-i18n-html="studio_index.1_pick_avatar">
						<span class="step-num">1</span> Pick avatar
					</h2>
					<p class="note" data-i18n-html="studio_index.to_see_your_avatar_here_make_it">To see your avatar here, make it public or unlisted in your <a href="/dashboard/avatars">avatar dashboard</a>. Or browse the <a href="/gallery" target="_blank" rel="noopener">community gallery</a>.</p>
					<div class="avatar-list" id="avatar-list" aria-busy="true"></div>
					<div class="browse-public">
						<div class="browse-public-row">
							<input
								type="search"
								id="public-search"
								placeholder="Search public avatars…"
								aria-label="Search public avatars"
								data-i18n-attr="aria-label:studio_index.public_search_arialabel"
								autocomplete="off"
								spellcheck="false"
							/>
							<button class="btn-ghost btn-sm" id="public-search-btn" type="button" data-i18n="studio_index.browse">Browse</button>
						</div>
						<div class="avatar-list" id="public-avatar-list" hidden></div>
						<div class="muted public-search-status" id="public-search-status" hidden></div>
					</div>
					<div class="browse-public model-url-row">
						<label class="field">
							<span data-i18n="studio_index.or_paste_a_model_url">Or paste a model URL</span>
							<div class="browse-public-row">
								<input
									type="url"
									id="model-url-input"
									placeholder="https://example.com/avatar.glb"
									aria-label="Model URL (.glb or .vrm)"
									data-i18n-attr="aria-label:studio_index.model_url_arialabel"
									autocomplete="off"
									spellcheck="false"
								/>
								<button class="btn-ghost btn-sm" id="model-url-btn" type="button" data-i18n="studio_index.use">Use</button>
							</div>
						</label>
						<p class="note" data-i18n="studio_index.host_your_own_glb_or_vrm">Host your own .glb or .vrm anywhere with permissive CORS and embed it without an account. The file is never uploaded to three.ws.</p>
						<div class="muted public-search-status" id="model-url-status" hidden></div>
					</div>
				</div>
				<div class="panel">
					<h2 data-tooltip="Each widget type is a different layout — Turntable for hero banners, Talking Agent for chat, Passport for on-chain identity, etc. Click to switch and watch the preview update." data-i18n-html="studio_index.2_pick_widget_type">
						<span class="step-num">2</span> Pick widget type
					</h2>
					<div class="type-grid" id="type-grid"></div>
				</div>
			</section>

			<section class="studio-col-mid" aria-label="Preview">
				<div class="preview-shell">
					<div class="preview-frame" id="preview-frame">
						<iframe
							id="preview-iframe"
							title="Live widget preview"
							allow="autoplay"
							loading="eager"
						></iframe>
					</div>
					<div class="preview-meta">
						<div class="device-switcher" role="group" aria-label="Preview device size">
							<button class="device-btn active" data-device="desktop" aria-pressed="true" aria-label="Desktop preview" data-tooltip="Desktop preview">
								<svg width="14" height="14" viewBox="0 0 14 14" fill="none" aria-hidden="true"><rect x="1" y="1.5" width="12" height="8.5" rx="1.5" stroke="currentColor" stroke-width="1.2"/><path d="M4.5 12h5M7 10v2" stroke="currentColor" stroke-width="1.2" stroke-linecap="round"/></svg>
							</button>
							<button class="device-btn" data-device="tablet" aria-pressed="false" aria-label="Tablet preview" data-tooltip="Tablet preview">
								<svg width="14" height="14" viewBox="0 0 14 14" fill="none" aria-hidden="true"><rect x="2" y="1" width="10" height="12" rx="1.5" stroke="currentColor" stroke-width="1.2"/><circle cx="7" cy="11.5" r="0.5" fill="currentColor"/></svg>
							</button>
							<button class="device-btn" data-device="mobile" aria-pressed="false" aria-label="Mobile preview" data-tooltip="Mobile preview">
								<svg width="14" height="14" viewBox="0 0 14 14" fill="none" aria-hidden="true"><rect x="3.5" y="1" width="7" height="12" rx="1.5" stroke="currentColor" stroke-width="1.2"/><circle cx="7" cy="11.5" r="0.5" fill="currentColor"/></svg>
							</button>
						</div>
						<span id="preview-status" class="muted" data-i18n="studio_index.pick_an_avatar_to_preview">Pick an avatar to preview</span>
						<button
							class="btn-ghost btn-sm"
							id="capture-camera-btn"
							type="button"
							data-tooltip="Drag to frame the avatar exactly how you want, then click to lock in that camera angle as the widget's default."
							disabled
						 data-i18n="studio_index.use_current_view">
							Use current view
						</button>
					</div>
				</div>
			</section>

			<section class="studio-col-right" aria-label="Brand and config">
				<div class="panel">
					<div class="studio-right-tabs" role="tablist">
						<button class="studio-right-tab" id="tab-brand" role="tab" aria-selected="true" aria-controls="panel-brand" data-i18n="studio_index.brand">Brand</button>
						<button class="studio-right-tab" id="tab-launch" role="tab" aria-selected="false" aria-controls="panel-launch" data-i18n="studio_index.launch">⚡ Launch</button>
					</div>

					<div id="panel-brand" role="tabpanel">
					<h2 data-tooltip="Style the widget to match your site — colors, environment, captions, and behavior. Changes update the preview live." data-i18n-html="studio_index.3_brand">
						<span class="step-num">3</span> Brand
					</h2>
					<form
						id="config-form"
						class="config-form"
						autocomplete="off"
					>
						<label
							class="field"
							data-tooltip="Internal name for this widget. Shows up in your dashboard — visitors never see it."
						>
							<span data-i18n="studio_index.name">Name</span>
							<input
								type="text"
								name="name"
								maxlength="120"
								required
								placeholder="My turntable widget"
							/>
						</label>
						<label
							class="field"
							data-tooltip="Backdrop color behind the avatar. Pick something close to your site's background for a seamless embed."
						>
							<span data-i18n="studio_index.background">Background</span>
							<input type="color" name="background" value="#0a0a0a" />
						</label>
						<label
							class="field"
							data-tooltip="Highlight color used for buttons, focus rings, and the chat bubble. Match your brand."
						>
							<span data-i18n="studio_index.accent">Accent</span>
							<input type="color" name="accent" value="#ffffff" />
						</label>
						<label
							class="field"
							data-tooltip="Optional text overlay shown below the avatar — great for a tagline or call-to-action."
						>
							<span data-i18n="studio_index.caption_optional">Caption (optional)</span>
							<input
								type="text"
								name="caption"
								maxlength="280"
								placeholder="Hello, world."
							/>
						</label>
						<label
							class="field row"
							data-tooltip="Show the orbit/zoom controls so visitors can rotate the avatar themselves. Turn off for a hands-off hero shot."
						>
							<input type="checkbox" name="showControls" checked />
							<span data-i18n="studio_index.show_controls">Show controls</span>
						</label>
						<label
							class="field row"
							data-tooltip="Slowly spin the avatar on its own. Pauses when the visitor interacts."
						>
							<input type="checkbox" name="autoRotate" checked />
							<span data-i18n="studio_index.auto_rotate">Auto-rotate</span>
						</label>
						<label
							class="field"
							data-tooltip="HDR lighting environment that affects how the avatar is lit and reflects. Try a few — they change the mood instantly."
						>
							<span data-i18n="studio_index.environment">Environment</span>
							<select name="envPreset">
								<option value="none" data-i18n="studio_index.none">None</option>
								<option value="neutral" selected data-i18n="studio_index.neutral">Neutral</option>
								<option value="venice-sunset" data-i18n="studio_index.venice_sunset">Venice sunset</option>
								<option value="footprint-court" data-i18n="studio_index.footprint_court">Footprint court</option>
							</select>
						</label>
						<label
							class="field row"
							data-tooltip="Public widgets load for anyone with the URL or embed snippet. Uncheck to keep it private to your account."
						>
							<input type="checkbox" name="is_public" checked />
							<span data-i18n="studio_index.public_widget_anyone_with_the_url_can">Public widget (anyone with the URL can load it)</span>
						</label>

						<div id="type-fields" class="type-fields"></div>
					</form>
					</div><!-- #panel-brand -->

					<div id="panel-launch" role="tabpanel" hidden>
						<!-- Mounted by studio.js via mountLaunchPanel -->
					</div>
				</div>

				<div class="action-row">
					<button
						type="button"
						class="btn-ghost"
						id="save-draft-btn"
						data-tooltip="Save your config to your dashboard without generating embed code. You can come back and tweak it later."
					 data-i18n="studio_index.save_draft">
						Save draft
					</button>
					<button
						type="button"
						class="btn-primary"
						id="generate-btn"
						data-tooltip="Save and produce a shareable URL plus the iframe/script snippets you can paste into your site."
					 data-i18n="studio_index.generate_embed">
						Generate embed
					</button>
				</div>
				<div class="action-secondary" id="action-secondary" hidden>
					<a
						class="btn-ghost btn-sm"
						id="view-live-btn"
						target="_blank"
						rel="noopener"
						data-tooltip="Open the live widget page in a new tab."
					>
						<svg width="12" height="12" viewBox="0 0 12 12" fill="none" aria-hidden="true"><path d="M5 2H2a1 1 0 0 0-1 1v7a1 1 0 0 0 1 1h7a1 1 0 0 0 1-1V7M7 1h4m0 0v4m0-4L5.5 6.5" stroke="currentColor" stroke-width="1.3" stroke-linecap="round" stroke-linejoin="round"/></svg>
						View live
					</a>
					<button
						type="button"
						class="btn-danger btn-sm"
						id="delete-widget-btn"
						data-tooltip="Permanently delete this widget. Cannot be undone."
					 data-i18n="studio_index.delete_widget">
						Delete widget
					</button>
				</div>
				<p id="form-error" class="form-error" hidden></p>
			</section>
		</main>

		<div class="modal-overlay" id="embed-modal" hidden>
			<div class="modal" role="dialog" aria-labelledby="embed-modal-title" aria-modal="true">
				<button type="button" class="modal-close" id="embed-modal-close" aria-label="Close" data-i18n-attr="aria-label:studio_index.close_arialabel">
					×
				</button>
				<h2 id="embed-modal-title" data-i18n="studio_index.your_widget_is_live">Your widget is live</h2>
				<p class="muted" data-i18n="studio_index.share_the_url_or_paste_the_snippet">Share the URL or paste the snippet anywhere.</p>
				<p id="embed-demo-note" class="muted" hidden data-i18n-html="studio_index.this_embeds_the_built_in_demo_agent">
					This embeds the built-in demo agent with its preset config — your studio
					tweaks aren't saved.
					<a href="/dashboard#upload">Upload your own avatar</a> to embed a customized
					widget.
				</p>
				<p id="embed-guest-note" class="muted" hidden data-i18n-html="studio_index.this_snippet_works_with_no_account">
					This snippet works right now, with no account: the whole configuration
					lives in the URL. <a href="/login">Sign in</a> to save it as a widget,
					get a shareable link, and change how it looks on live sites without
					touching their code again.
				</p>

				<div class="embed-preview">
					<iframe
						id="embed-preview-iframe"
						title="Embed preview"
						allow="autoplay"
					></iframe>
				</div>

				<label class="field" id="embed-share-field">
					<span data-i18n="studio_index.shareable_url">Shareable URL</span>
					<div class="copy-row">
						<input type="text" id="embed-share-url" readonly />
						<button type="button" class="btn-ghost btn-sm" data-copy="#embed-share-url" data-i18n="studio_index.copy">
							Copy
						</button>
					</div>
				</label>

				<div style="display:flex;gap:12px">
					<label class="field">
						<span data-i18n="studio_index.width_px">Width (px)</span>
						<input type="number" id="embed-width" value="600" min="100" max="3000" step="10" />
					</label>
					<label class="field">
						<span data-i18n="studio_index.height_px">Height (px)</span>
						<input type="number" id="embed-height" value="600" min="100" max="3000" step="10" />
					</label>
				</div>

				<div id="embed-options" hidden>
					<p style="margin:12px 0 6px;font-size:0.82em;text-transform:uppercase;letter-spacing:0.05em;opacity:0.5" data-i18n="studio_index.include_in_embed">Include in embed</p>
					<label class="field row" id="embed-opt-animations" hidden>
						<input type="checkbox" id="embed-include-animations" checked />
						<span data-i18n="studio_index.animations_panel">Animations panel</span>
					</label>
					<label class="field row" id="embed-opt-chat" hidden>
						<input type="checkbox" id="embed-include-chat" checked />
						<span data-i18n="studio_index.chat_ui">Chat UI</span>
					</label>
					<label class="field row" id="embed-opt-controls" hidden>
						<input type="checkbox" id="embed-include-controls" checked />
						<span data-i18n="studio_index.3d_orbit_controls">3D orbit controls</span>
					</label>
				</div>

				<label class="field">
					<span data-i18n="studio_index.iframe_snippet">iframe snippet</span>
					<div class="copy-row">
						<textarea id="embed-iframe-snippet" rows="3" readonly></textarea>
						<button
							type="button"
							class="btn-ghost btn-sm"
							data-copy="#embed-iframe-snippet"
						 data-i18n="studio_index.copy_2">
							Copy
						</button>
					</div>
				</label>

				<div class="embed-platforms">
					<p class="embed-platforms-title" data-i18n="studio_index.where_does_this_go">Where does this go?</p>
					<div class="embed-platform-tabs" id="embed-platform-tabs" role="group" aria-label="Platform"></div>
					<p class="muted embed-platform-note" id="embed-platform-note"></p>
				</div>

				<details id="embed-script-field">
					<summary data-i18n="studio_index.script_tag_embed">Script-tag embed</summary>
					<div class="copy-row">
						<textarea id="embed-script-snippet" rows="2" readonly aria-label="Script-tag embed snippet" data-i18n-attr="aria-label:studio_index.script_snippet_arialabel"></textarea>
						<button
							type="button"
							class="btn-ghost btn-sm"
							data-copy="#embed-script-snippet"
						 data-i18n="studio_index.copy_3">
							Copy
						</button>
					</div>
				</details>
				<p class="muted" data-i18n-html="studio_index.want_to_try_the_viewer_full_page">
					Want to try the viewer full-page with environments and embed code side by side?
					Open the <a href="/playground">Playground</a>.
				</p>
			</div>
		</div>

		<div class="toast" id="toast" hidden></div>

		<script type="module" src="/studio/studio.js?v=4"></script>
		<script src="/brand.js" defer></script>
	<!-- Runtime i18n: detects locale, swaps annotated copy, mounts <lang-switcher>. -->
	<script type="module" src="/i18n.js"></script>
</body>
</html>