# POS Apps

> Build custom apps that run inside Pancake POS: add actions, blocks, pages and hooks to the POS interface, and read/write data through the Open API. Apps are private to a single shop.

## Docs

- [Overview & design](https://crm.pancake.biz/developers/apps/overview.md): Concepts, architecture, security model, choosing a presentation and roadmap.
- [Getting started](https://crm.pancake.biz/developers/apps/getting-started.md): Create a project, declare extensions, try it inside POS, upload and activate the app.
- [Manage apps in POS](https://crm.pancake.biz/developers/apps/manage-apps.md): Open the Custom apps page, review access and activate versions, turn apps on and off, go back to an older version, read errors, connect the CLI and use development mode.
- [Build with AI](https://crm.pancake.biz/developers/apps/ai-guide.md): Connect the pos-app MCP server to Claude Code, Cursor, Codex…, sample prompts, reporting bugs to Pancake and the rules AI tools must follow.
- [Examples](https://crm.pancake.biz/developers/apps/examples.md): A complete sample app: block, headless action, modal action, hook, iframe page and a bulk action on warehouse transfers.
- [Manifest (pos-app.json)](https://crm.pancake.biz/developers/apps/manifest.md): Declare an app: data access, allowed external domains and the list of extensions.
- [Extension points](https://crm.pancake.biz/developers/apps/targets.md): Where apps attach inside POS for orders, products, purchases, exports and warehouse transfers, how each target is presented and what context data it receives.
- [UI components](https://crm.pancake.biz/developers/apps/components.md): The pos-* elements available to Worker UI extensions: properties, events and rules.
- [Runtime API (pos)](https://crm.pancake.biz/developers/apps/runtime-api.md): The pos object in extensions and iframe pages: context, API calls, toasts, navigation and events.
- [Data access](https://crm.pancake.biz/developers/apps/data-access.md): App tokens, permissions, the Open API, rate limits, error codes and background tasks.
- [SDK & CLI](https://crm.pancake.biz/developers/apps/sdk.md): SDK packages, how the SDK and the POS runtime split the work, TypeScript setup, defineExtension and the pos-app command.

## Optional

- [Full docs for AI](https://crm.pancake.biz/developers/apps/llms-full.txt)
- [Tiếng Việt](https://crm.pancake.biz/developers/apps/vi/llms.txt)
- [Pancake POS Developers](https://crm.pancake.biz/developers/llms.txt)