Popmelt

v0.36.0

Popmelt

v0.36.0
© 2026 Popmelt
HelpPrivacyTerms
Docs

  • Getting started with Popmelt Core
  • Creating annotations with the Chat tool
  • Comparing and refining options with Explore
  • Tweaking styles with the Steer tool
  • Helping your AI understand your taste with the Imprint tool
  • Using Popmelt with Three.js and react-three-fiber
  • Add custom context to Popmelt annotations and threads
  • Recovering an annotation that won’t send
  • Inviting a teammate to a local session
  • Where Popmelt saves and sends your data

  • Annotating static objects in images
  • Annotating moving objects in video
Docs/Core

Comparing and refining options with Explore

Try alternatives on your page, refine a single option, and apply the version you choose.

Suppose your homepage has a “Let’s try Popmelt” button. Clicking it copies a setup prompt, but visitors might expect it to install something. Explore lets you try several ways to explain that action in the space the button actually occupies.

Ask for alternatives

Choose Chat, click the invitation on the page, and send an annotation like this one.

/explore Try three ways to show that clicking this button copies a prompt for my agent. Keep one close to the original with a visible copy icon.

In an existing thread attached to one element, click the reply field. Type /e and press Tab to complete /explore, or type the full command. Add what you want to vary, then press Enter to send. The first completed option opens in a preview card. You can act on it while the remaining options build.

The request can build on feedback already in the thread.

Compare on the page

The card opens on the first suggestion. Click the left arrow beside the option count to reach Original (option 0). Click the right arrow to return to option 1 or compare the next suggestion. Read the rationale beneath the card to see what changed and why.

The option counter, preview and rationale change together.

Use the eye to see how the option fits beside the actual headline and surrounding content. The eye badge on the page annotation lets you flip it off and on again.

Use the expanded canvas

On desktop, hover over the preview card and click Expand preview in its upper-right corner. The canvas opens beside the thread. Use the arrows beside the option count to compare alternatives, then click + to inspect the copy or icon spacing. Click Collapse preview to return to the card with the same option selected.

The thread stays open beside the canvas as you compare options.

On a phone, tap Expand preview. The canvas fills the space above the reply field. Tap an arrow or swipe across the option counter to change options. Tap + to zoom in, then drag the preview to pan. Tap Collapse preview in the upper-right corner to bring back the transcript.

The reply field stays within reach beneath the expanded phone preview.

Refine just one option

Click the label inside the option you want to refine. Its badge appears above the reply field. With that badge attached, send “Keep the copy icon and shorten this label.” The agent receives the option and the element you picked. If you want a change across the whole set, say so explicitly.

The v3 badge identifies the option that should receive the edit.

On desktop you can also double-click text to edit it directly or stage a style change in the preview. These edits save with that option in the project. You can pick them up from the same thread on a paired phone. To try the button’s own interaction on desktop, hold Option or Alt while clicking it.

Apply and revisit

With the option previewed on the page, click its checkmark. This sends a request to implement that option, including its saved edits. Review the resulting change in your app.

The colored eye identifies the previewed option. Its checkmark requests implementation.

Use the archive icon in the thread title bar to move it off the page. To revisit it, open History from the toolbar, search for words from the original request, and select the matching thread. Click the option name in the Apply message to jump back to its card. On a revision, Based on opens the exact parent version with the edits you submitted, and Back to iteration returns to the revision.

New rounds save the compiled previews alongside their editing recipes in .popmelt/, so the cards can replay after the source changes. If an older round has only a recipe, replay depends on whether the checkout can still reproduce it.

A search for “setup prompt” finds the earlier exploration.

Next: Continue a thread or pair your phone.

Didn't find the answer? Have an idea?

Ask a question