Skip to content
biticaretdevelopers

biticaret developer docs

Build themes and apps for biticaret stores with the biticaret CLI, Liquid and the App API. For people and for AI coding agents.

Quick start

With the CLI on your PATH (Install the CLI), sign in and create a starter theme and app:

biticaret auth loginbiticaret theme init my-themebiticaret app init my-app

Every command and flag is documented on the CLI page.

Build a theme

  1. Start from the skeleton theme, biticaret/skeleton-theme:
    biticaret theme init my-theme cd my-theme

  2. Edit the templates, sections and blocks. Theme structure explains how a theme is organised.

  3. Run the upload checks:
    biticaret theme check --strict .

  4. Zip the theme folders and upload the archive in your development store's admin under Online Mağaza > Temalar (Online store > Themes).

Full walkthrough: Build a theme.

Build an app

  1. Start from the Go template, biticaret/app-template-go. Pass --template to start from an example app instead: theme-blocks, functions or ui-extensions.
    biticaret app init my-app cd my-app

  2. Check the configuration. This works offline:
    biticaret app check

  3. Sign in and create the app in your organisation:
    biticaret auth login biticaret app config link

  4. Upload a version and release it:
    biticaret app deploy --submit

Full walkthrough, including server setup and installation: Build an app.

For AI agents

Every page is also available as Markdown at the same URL with a .md extension. llms.txt lists every page, and llms-full.txt combines all of them into one file. The AGENTS.md files in the starter projects point coding agents here. biticaret mcp serves these same docs, schemas and checks as an MCP server: see Work with an AI coding agent.