Skip to content

adamperlis/companion-bot

v0.1.0MIT

A furry 3D companion for your web app: a drop-in <companion-bot> element with moods and expressions, plus a customizer users can restyle it with.

companion-bot

Add a furry 3D companion bot to a web app — a drop-in <companion-bot> web component that blinks, glances at the pointer, fidgets, hops when clicked, and shows the app's mood (idle, working, sleeping), plus a full customizer (presets, fur, face, nose, eyes, 14 glasses frames, saved presets) for a settings page. Three.js on WebGPU, falling back to WebGL 2, then a flat WebGL 1 shader, then a still picture. Use when someone wants a mascot, companion, buddy, avatar or character in their UI — in a header, empty states, loading or "all done" states, onboarding — or wants users to customize one. Works in plain HTML, React, Next.js, Vue, Svelte and Astro with no build step.

Read SKILL.md at the source

Pinned to revision 6da1e9b6b958, so it is the text this page describes rather than whatever the author pushed since.

Files

Every link opens the file at its source, pinned to the revision this page describes.