# DeepBot apps

> DeepBot is an AI agent that runs on the person's computer. A DeepBot app adds cards in the chat, pages in DeepBot, a skill for the Bot and optional scripts. This is everything needed to build, test and publish one.

To build an app, read https://deepbot.studio/llms-full.txt (all of it, one file) or install the skill: https://deepbot.studio/skill/deepbot-app-builder.zip (a folder with SKILL.md; unzip into your skills folder).

## Docs
- [Build an app with your AI](https://deepbot.studio/skill/deepbot-app-builder/SKILL.md): The whole workflow the skill gives your AI: understand, choose the parts, write, test, publish.
- [Where apps show up](https://deepbot.studio/skill/deepbot-app-builder/references/surfaces.md): Cards in the chat, pages in DeepBot, the Apps page and the catalogue, with pictures.
- [app.json](https://deepbot.studio/skill/deepbot-app-builder/references/manifest.md): Every field, permissions, cards, pages and the checks.
- [Bridge API](https://deepbot.studio/skill/deepbot-app-builder/references/bridge.md): Every deepbot.* call: files, storage, ask, network, secrets, navigation, done and fail.
- [The app's skill](https://deepbot.studio/skill/deepbot-app-builder/references/app-skill.md): Writing the SKILL.md that makes the Bot use your app well.
- [Design](https://deepbot.studio/skill/deepbot-app-builder/references/design.md): The kit, colours, light and dark, layout rules.
- [Scripts](https://deepbot.studio/skill/deepbot-app-builder/references/scripts.md): Work on the person's computer, driven by the Bot.
- [Patterns for big apps](https://deepbot.studio/skill/deepbot-app-builder/references/patterns.md): Data models, editors, uploads, exports, WebGL, WASM, long jobs, keys, tests.
- [The app page](https://deepbot.studio/skill/deepbot-app-builder/references/listing.md): listing.md and pictures: what makes each part of the catalogue page.
- [Test and publish](https://deepbot.studio/skill/deepbot-app-builder/references/publish.md): Developer mode, the test pass, tags, submitting, updates, review.
- [Reserved card names](https://deepbot.studio/skill/deepbot-app-builder/references/reserved-cards.md): Names DeepBot already uses.

## Examples (complete, working apps)
- [Notes board](https://deepbot.studio/developers/examples/notes-board): A card and a page: files the Bot writes, storage for pins, ask and openPage. Download: https://deepbot.studio/developers/examples/notes-board.zip
- [Quick weather](https://deepbot.studio/developers/examples/quick-weather): A card that calls a web API itself through deepbot.net.fetch. Download: https://deepbot.studio/developers/examples/quick-weather.zip
- [Image tools](https://deepbot.studio/developers/examples/image-tools): A Python script the Bot runs on the computer, and a result card with pictures. Download: https://deepbot.studio/developers/examples/image-tools.zip

## Catalogue API
- [Apps](https://deepbot.studio/api/v1/apps): the published apps, as JSON