Developers
Start building
Poltura developer docs

Build for Poltura.

Extend the admin and storefront with apps, craft themes for the customizer, and tap into store data with the API. Written for you and your AI assistant.

$ poltura app create my-appcreated hosted app in ./my-app$ poltura app publishpublished, waiting for review
RecommendationsVersion 1.0.0Approved

Get started.

$ claude mcp add poltura/mcp: Authenticate
Claude CodePoltura

Connect an AI tool

Sign in, pick a store and ask about last week’s sales.

claude mcp add --transport http poltura https://api.poltura.com/mcp
Add the MCP server
In the draft
Free delivery over 50usp-strip

Build a theme

A new section in the theme draft, in the browser. Nothing to install.

Online store → Themes → Edit in code editor
Build a theme section
$ poltura app validateok my-app@1.0.0
Apps

Build an app

An admin page, a storefront block and a server, built and validated.

poltura app create my-app --template hosted
Build your first app
Build a Poltura app with your AI toolPaste into your AI coding tool. It points the tool at these docs.
Build a Poltura app. Before writing code, read https://developers.poltura.com/llms.txt and https://developers.poltura.com/apps/build-your-first-app.md, and follow https://developers.poltura.com/ai/rules/AGENTS.md. Scaffold it with `poltura app create my-app --template hosted`, declare only the permissions the app needs with a purpose for each, and run `poltura app build` and `poltura app validate` until both pass.

Pick what you build.

Apps

Add admin pages, product panels and storefront blocks to every store that installs your app. One manifest, reviewed before it ships.

poltura app create my-appBuild your first app

AI tools

Connect Claude, ChatGPT, Cursor, VS Code or Codex to a store over MCP. Every page here as Markdown, llms.txt, rules files and ready prompts.

claude mcp add polturaBuild with AI

The Poltura ecosystem.

Ship to merchants →

Apps add pages, panels and storefront blocks to the stores that install them. Themes draw the storefront merchants arrange in the Customizer. Your server reaches store data through the App API, within the permissions each merchant granted. AI tools read every page here as Markdown and work in a store through the Poltura MCP server.

Listing third-party apps in the Poltura app store is planned.

  1. 1BuildWorkers, a manifest and your server, or a theme section.Manifest
  2. 2Checkpoltura app validate checks the release the way review does.CLI
  3. 3Publishpoltura app publish uploads the release for review.Publishing
  4. 4ReviewA Poltura reviewer outside your team approves every release.Review
  5. 5InstallThe merchant approves your permissions on Poltura’s permission screen.The install flow
  6. 6RunYour server calls the App API and receives signed webhooks.App API

Popular guides.

For AI tools

Docs your agent can read.

Every page has a Markdown twin, the whole site fits in one file, and the rules files teach Cursor, Claude Code and Codex the Poltura conventions before they write a line.

What’s new.

Changelog →
Theme SDKDeveloper platform launchThe Poltura developer platform is now open. Build storefront themes with the Theme SDK, build apps with the App SDK, and manage development through the poltura command line tool.