Build this concept in 5 minutes👇

Avatar Concept.gif


Step 1 - Build the avatar

Open avatars.bible-strong.app. The studio builds procedural 2D avatars in SVG, so everything stays sharp at any size and weighs almost nothing.

Screenshot 04-09-2026- 15-05-C81FAEFF-DA9B-47B8-BD1A-63B043C994B3.png

Three things to set up before you export:

  1. The body. Compose the face from the surfaces and primitives in the editor.
  2. The expressions. These are named presets with their own color and eye overrides. Name them for the states you actually need, not for emotions. idle, typing, error, success will serve you better than happy and sad.
  3. The animations. Sequences of expressions with your own timing and transitions.

Export as a .avatar.json file. That single file drives both renderers, so the avatar cannot look different in React than it does in the studio.

<aside> 🎯

Name your expressions after interface states. This is the whole trick. Claude wires the avatar to your form by matching expression names to events, so an expression called error gets connected correctly on the first try. An expression called grumpy needs you to explain what it means.

</aside>


Step 2 - Hand it to Claude Code

Copy the repo link, paste it into Claude Code, and describe what you want to build with it. Here is the prompt I used for the reactive sign up page:

Read this repo: https://github.com/smontlouis/bible-strong-avatar-lab

It is a procedural 2D avatar system. Avatars are defined in .avatar.json files
and rendered with @bible-strong/avatar-react. Expressions are named presets and
animations are sequences of expressions.

Build me a single-page sign up form that uses this avatar as the centerpiece,
and make the avatar react to the user in real time:

- Idle when nothing is focused
- Looks toward the field that is currently focused
- Covers its eyes while the password field has focus
- Plays the error expression when a field fails validation on blur
- Plays the success expression when the form submits cleanly

The form has: name, email, password, and a submit button.

Use React with Tailwind. Centered layout, generous spacing, one accent color.
Keep the avatar large - it is the hero of the page, not an icon.

Wire the reactions through the avatar's expression API, do not fake them with
CSS. Show me the component structure before you write the full implementation.

<aside> 🗣️

Voice note it instead of typing it. I dictate prompts this long rather than typing them. You describe the interaction the way you would explain it to a person, and you end up giving Claude more context than you would have bothered to type out.

</aside>

Hit enter and let Claude cook. Read the component structure it proposes before you let it build everything, since fixing the structure later costs far more than fixing it now.