Building themes with AI

Stayblox themes work well with AI coding agents such as Claude Code and Cursor. The platform gives your agent three things: machine-readable docs, an agent-ready scaffold, and a local MCP server with validation and preview tools.

Machine-readable documentation

• /llms.txt is a compact index of this documentation.
• /llms-full.txt is the full corpus in one file.

Point your agent at either URL, or rely on the bundled offline search described below.

Start from the scaffold

npm install -g @stayblox/cli
stayblox theme init my-theme

The scaffold includes two files that make agents productive immediately:

• AGENTS.md describes the theme structure and the validate-after-every-change loop.
• .mcp.json registers the stayblox mcp server, so agent tools are available as soon as the agent opens the project.

The dev MCP server

Run stayblox mcp (agents with .mcp.json support start it automatically). Tools useful for theme work:

Tool	What it does
search_docs	Searches this documentation offline.
validate_theme	Validates the theme against the platform rules and returns structured errors.
package_theme	Builds the distributable zip without uploading.
push_dev	Uploads the theme to your development store and returns a preview URL.

Validation and preview call the Stayblox API, so run stayblox login once before starting your agent.

A working loop

1. Describe the change you want to the agent.
2. The agent edits the theme's Liquid files, then calls validate_theme and fixes every reported error.
3. The agent calls push_dev and gives you the preview URL to review.