Building with AI

Connect Claude, ChatGPT, Claude Code, Cursor or any MCP client to a sandbox, then describe the theme you want. The assistant uses the same tools as the editor and follows the same theme store rules. It runs on your own AI subscription, so it doesn't use Joomni credits.

In the dashboard:Joomni Studio › Sandboxes › AI assistantPlan:All builders

Connect an assistant

  1. Open the sandbox's AI tab

    From AI connections, or from a sandbox card, click Connect an assistant.
  2. Claude or ChatGPT

    Add a custom connector with the URL shown on the page, then sign in. Your sandbox is already selected on the consent screen.
  3. Claude Code, Cursor or VS Code

    Create a key on the same page and copy it. It's shown only once. Then add the server, for example:
    claude mcp add --transport http joomni-studio <URL> --header "Authorization: Bearer <your key>"

One connection, one sandbox

A connection only reaches the sandbox it was made for, never one of your real stores. To work on another sandbox, connect it separately. AI connections lists every sandbox and shows which ones have an assistant connected.

Commands

These commands appear in your assistant once it's connected:

CommandWhat it does
/joomni:build-themeBuilds a whole theme from a one-line brief: design settings, header, footer and every page, then runs the review until it passes.
/joomni:restyle-themeA new palette, fonts, corner radius, spacing and buttons, without changing the structure.
/joomni:theme-from-referenceCopies the feel of a site or an image you paste in.
/joomni:liquid-sectionWrites one custom Liquid section and previews it with real data before adding it.
/joomni:check-themeRuns the theme store review, explains each failure and fixes it.
/joomni:prepare-submissionWrites the listing copy, passes the review and gets a version ready for you to submit.
/joomni:address-reviewWorks through a reviewer's feedback on a submitted version.
/joomni:vertical-variantAdapts a copy of the theme for another store type.

Staying in control

SafeguardWhat it does
Same rules as building by handThe assistant can't add custom code and runs the same automated review as Submit.
Live in the editorChanges show up in the page editor as they happen.
UndoPages and theme settings are saved before each change. Undo it from the sandbox's AI tab under Recent AI changes.
Deletions wait for youRoutine edits in a sandbox go through without asking. Deleting anything always needs your yes.
You submitAn assistant can get a version ready but can't submit it. Submitting confirms your originality declaration, so it stays a click in Studio.

Reviewers can see AI use

Reviewers see how many changes an assistant made. Building with AI is allowed and doesn't count against you. The note is there so reviewers understand how the theme was made.

For the Liquid details an assistant works from (drops, widgets and standards), see the Liquid guide in Studio.

Need a hand?