# 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](cli.md#install-the-cli)), sign in and create a starter theme and app:

```bash
biticaret auth login
biticaret theme init my-theme
biticaret app init my-app
```

Every command and flag is documented on the [CLI](cli.md) page.

## Build a theme

1. Start from the skeleton theme, [biticaret/skeleton-theme](https://github.com/biticaret/skeleton-theme):

   ```bash
   biticaret theme init my-theme
   cd my-theme
   ```

2. Edit the templates, sections and blocks. [Theme structure](themes/structure.md) explains how a theme is organised.

3. Run the upload checks:

   ```bash
   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](getting-started.md#build-a-theme).

## Build an app

1. Start from the Go template, [biticaret/app-template-go](https://github.com/biticaret/app-template-go). Pass `--template` to start from an example app instead: [theme-blocks](https://github.com/biticaret/example-app-theme-blocks), [functions](https://github.com/biticaret/example-app-functions) or [ui-extensions](https://github.com/biticaret/example-app-ui-extensions).

   ```bash
   biticaret app init my-app
   cd my-app
   ```

2. Check the configuration. This works offline:

   ```bash
   biticaret app check
   ```

3. Sign in and create the app in your organisation:

   ```bash
   biticaret auth login
   biticaret app config link
   ```

4. Upload a version and release it:

   ```bash
   biticaret app deploy --submit
   ```

Full walkthrough, including server setup and installation: [Build an app](getting-started.md#build-an-app).

## Popular references

- [Theme objects](themes/objects.md)
- [Theme filters](themes/filters.md)
- [App API routes](reference/api-routes.md)
- [Webhook topics](reference/webhook-topics.md)
- [biticaret.app.toml keys](reference/app-toml.md)

## For AI agents

Every page is also available as Markdown at the same URL with a `.md` extension. [llms.txt](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](cli.md#work-with-an-ai-coding-agent).
