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
import { useState, type CSSProperties } from "react";
import { createPortal } from "react-dom";
import type { ReadyShader, ReadyShaderCategory } from "../data/shaders";
import { READY_SHADER_CATEGORIES } from "../data/shaders";
import { COMMUNITY_NEWEST_SHADER_IDS } from "../data/communityOrder";
import { VISIBLE_READY_SHADERS } from "../data/publicShaders";
import { BrandMark } from "./BrandMark";
import { ChevronIcon, MaximizeIcon, SearchIcon } from "./icons";
import { GitHubStars } from "./GitHubStars";
import { RightRailPromos } from "./RightRailPromos";
import { ThemeButtons } from "./ThemeButtons";
import { UpgradeLink } from "./UpgradeLink";
import type { ThemeMode, ThemePalette } from "../theme";
type SidebarProps = {
active: ReadyShader;
browseActive: boolean;
installationActive: boolean;
mcpActive: boolean;
open: boolean;
theme: ThemeMode;
palette: ThemePalette;
onSelect: (id: ReadyShader["id"]) => void;
onBrowse: () => void;
onInstallation: () => void;
onMcp: () => void;
onPricing: () => void;
onSearch: () => void;
onTheme: (mode: ThemeMode) => void;
};
type SidebarCatalogSectionProps = Pick<SidebarProps, "active" | "installationActive" | "onSelect"> & {
label: string;
shaders: readonly ReadyShader[];
onPreview: (shader: ReadyShader, target: HTMLButtonElement) => void;
onPreviewEnd: () => void;
};
type SidebarPreview = {
thumbnail: string;
top: number;
left: number;
};
function getSidebarPreviewThumbnail(shader: ReadyShader) {
return shader.variants?.[0]?.thumbnail ?? shader.thumbnail;
}
const NEWEST_SHADER_RANK = new Map<ReadyShader["id"], number>(
COMMUNITY_NEWEST_SHADER_IDS.map((id, index) => [id, index]),
);
function orderNewestFirst(shaders: readonly ReadyShader[]) {
return shaders
.map((shader, index) => ({ shader, index }))
.sort((a, b) => (
(NEWEST_SHADER_RANK.get(a.shader.id) ?? Number.MAX_SAFE_INTEGER)
- (NEWEST_SHADER_RANK.get(b.shader.id) ?? Number.MAX_SAFE_INTEGER)
|| a.index - b.index
))
.map(({ shader }) => shader);
}
const NEWEST_SHADER_ID_SET = new Set<ReadyShader["id"]>(COMMUNITY_NEWEST_SHADER_IDS);
export const RECENT_SHADERS = orderNewestFirst(VISIBLE_READY_SHADERS).filter((shader) => NEWEST_SHADER_ID_SET.has(shader.id));
const COMMUNITY_SHADERS = orderNewestFirst(VISIBLE_READY_SHADERS);
function SidebarCatalogSection({ label, shaders, active, installationActive, onSelect, onPreview, onPreviewEnd }: SidebarCatalogSectionProps) {
const [expanded, setExpanded] = useState(true);
const [openCategories, setOpenCategories] = useState<Set<ReadyShaderCategory>>(
() => new Set(READY_SHADER_CATEGORIES),
);
const categories = READY_SHADER_CATEGORIES.filter((category) => (
shaders.some((shader) => shader.category === category)
));
return (
<div className="nav-section">
<h2 className="nav-label">
<button
className="nav-section-toggle"
type="button"
aria-expanded={expanded}
onClick={() => setExpanded((current) => !current)}
>
<span>{label}</span>
<MaximizeIcon className="maximize-icon" />
</button>
</h2>
<div className={`nav-children${expanded ? " is-open" : ""}`}>
<div>
{categories.map((category) => {
const categoryExpanded = openCategories.has(category);
return (
<div className="nav-block" key={category}>
<button
className="nav-group"
aria-expanded={categoryExpanded}
onClick={() => setOpenCategories((current) => {
const next = new Set(current);
if (next.has(category)) next.delete(category);
else next.add(category);
return next;
})}
>
{category}
<ChevronIcon className="chev" />
</button>
<div className={`nav-children${categoryExpanded ? " is-open" : ""}`}>
<div>
<div className="nav-list">
{shaders.filter((shader) => shader.category === category).map((shader) => (
<button
className={`nav-link${!installationActive && active.id === shader.id ? " active" : ""}`}
key={shader.id}
aria-current={!installationActive && active.id === shader.id ? "page" : undefined}
onPointerEnter={(event) => onPreview(shader, event.currentTarget)}
onPointerLeave={onPreviewEnd}
onFocus={(event) => onPreview(shader, event.currentTarget)}
onBlur={onPreviewEnd}
onClick={() => {
onPreviewEnd();
onSelect(shader.id);
}}
>
<span>{shader.label}</span>
<span className="nav-link-badges">
{shader.variants && shader.variants.length > 1 ? (
<span
className="variant-count"
aria-label={`${shader.variants.length} variants`}
title={`${shader.variants.length} variants`}
>
{shader.variants.length}
</span>
) : null}
</span>
</button>
))}
</div>
</div>
</div>
</div>
);
})}
</div>
</div>
</div>
);
}
export function Sidebar({ active, browseActive, installationActive, mcpActive, open, theme, palette, onSelect, onBrowse, onInstallation, onMcp, onPricing, onSearch, onTheme }: SidebarProps) {
const [preview, setPreview] = useState<SidebarPreview | null>(null);
const showPreview = (shader: ReadyShader, target: HTMLButtonElement) => {
const bounds = target.getBoundingClientRect();
const width = 240;
const height = 135;
const viewportPadding = 12;
const top = Math.min(
window.innerHeight - height - viewportPadding,
Math.max(viewportPadding, bounds.top + bounds.height / 2 - height / 2),
);
const left = Math.min(window.innerWidth - width - viewportPadding, bounds.right + 12);
setPreview({ thumbnail: getSidebarPreviewThumbnail(shader), top, left });
};
return (
<aside className={`sidebar${open ? " open" : ""}`} id="sidebar">
<div className="sb-head">
<div className="sb-brand-row">
<button className="brand-button" aria-label="Browse ThreeUI" onClick={onBrowse}>
<BrandMark />
</button>
<GitHubStars />
</div>
<button className="search inset-shadow" onClick={onSearch}>
<SearchIcon style={{ opacity: 0.7 }} />
<span className="ph">Search...</span>
<kbd>⌘ K</kbd>
</button>
</div>
<div className="sb-scroll scroll-area" onScroll={() => setPreview(null)}>
<nav className="sb-nav" aria-label="ThreeUI documentation">
<div className="nav-section">
<h2 className="nav-label">Documentation</h2>
<div className="nav-list nav-list-root">
<button
className={`nav-link${browseActive ? " active" : ""}`}
aria-current={browseActive ? "page" : undefined}
onClick={onBrowse}
>
<span>Browse</span>
</button>
<button
className={`nav-link${installationActive ? " active" : ""}`}
aria-current={installationActive ? "page" : undefined}
onClick={onInstallation}
>
<span>Installation</span>
</button>
<button
className={`nav-link${mcpActive ? " active" : ""}`}
aria-current={mcpActive ? "page" : undefined}
onClick={onMcp}
>
<span>MCP</span>
</button>
</div>
</div>
<SidebarCatalogSection
label="ThreeUI"
shaders={COMMUNITY_SHADERS}
active={active}
installationActive={installationActive || mcpActive || browseActive}
onSelect={onSelect}
onPreview={showPreview}
onPreviewEnd={() => setPreview(null)}
/>
</nav>
<div className="sidebar-promos-mobile">
<RightRailPromos onPricing={onPricing} />
</div>
</div>
<div className="sb-foot">
<UpgradeLink />
<ThemeButtons mode={theme} palette={palette} onChange={onTheme} />
</div>
{preview && typeof document !== "undefined" ? createPortal(
<div
className="sidebar-preview-tooltip"
style={{ "--sidebar-preview-top": `${preview.top}px`, "--sidebar-preview-left": `${preview.left}px` } as CSSProperties}
aria-hidden="true"
>
<img src={preview.thumbnail} alt="" />
</div>,
document.body,
) : null}
</aside>
);
}