On this page
A Tanqory theme is a React app written in TypeScript. That matters more than it sounds: the coding agents developers already use know React well, so you can describe a change in a sentence and let the agent write it, run it and upload it. The visual editor keeps working on the same theme afterwards, so the merchant can still arrange sections and change text without code.
Here is the whole loop, with the commands the agent will run.
Step 1: Install the CLI and sign in
The CLI is the npm package @tanqory/cli and runs on Node.js 18 or later.
npm install -g @tanqory/cli
tanqory login
tanqory whoami
login opens your browser, where you approve the CLI, and stores the token on your machine. whoami prints the account it belongs to.
Themes are built in a dev store, not in a live one. If you have none yet, create one at dev.tanqory.com first.
Step 2: Get the theme onto your machine
Pick the command for where you start:
| You have | Run |
|---|---|
| A theme in your dev store | tanqory theme pull |
| A theme folder on your machine | tanqory theme push |
| Nothing yet | tanqory theme init |
init scaffolds Nova, the reference theme, which needs Node.js 22.6 or later and pnpm 9.7 or later. Both init and pull write a tanqory.json file that links the folder to its store and theme, so later commands need no flags.
Step 3: Run it on real data
tanqory theme dev
The theme runs at http://localhost:4321 with your dev store's real products and pages. Add --mock to work offline with bundled sample data, or --sync to push every saved change to the store theme so the visual editor follows your code. Live-sync waits one second after your last change before it pushes, and pushes never overlap.
Step 4: Hand the change to your agent
Open your coding agent in the theme folder and give it the loop in plain words, followed by the change you want:
Install the Tanqory CLI with `npm install -g @tanqory/cli` and sign in with `tanqory login`.
In my theme folder, run `tanqory theme dev` to open the theme at localhost:4321.
Make the change I describe, then upload it with `tanqory theme push`.
Change: give the product page a sticky add-to-cart bar on mobile.
Any agent that can run a terminal works. Check the result on localhost before you let it push.
Step 5: Push, then publish
tanqory theme push uploads your source to the linked theme, the storefront rebuilds and the theme shows in your store's Theme library. Pushing does not make a theme live: that is the Publish action in the Theme library, which you press when you are happy with the preview.
One rule saves a lot of confusion. Push and live-sync overwrite the theme's files, so if someone edits content in the visual editor while you push code, one can overwrite the other. Run tanqory theme pull before you go back to code.
Not writing code?
You can still change a theme by asking. In Studio, Tanqory AI can generate a whole theme or edit the one you have, down to its code, and you approve the change before it goes live. See themes for what the editor and the AI can do, or the CLI docs for every command.
