# Xeer

> Xeer is a framework for building and shipping full-stack apps: a declarative manifest, a typed
> server, a reactive client, a database and object store you declare rather than provision, a test
> runner, and one command to deploy. Every CLI command emits structured JSON and every failure
> carries a stable `XE####` code with a suggested repair.

Each page below is available as Markdown at the URL given, and the whole corpus is at
https://docs.xeer.run/llms-full.txt. Diagnostic codes are generated from the compiler's own catalogue.

- [Xeer](https://docs.xeer.run/index.md): Xeer is a framework for building and shipping full-stack apps. A typed server, a reactive client, a built-in test runner, and one command to deploy.

## Start here

- [Quickstart](https://docs.xeer.run/quickstart.md): Create, run, test, and deploy a Xeer app in five minutes.
- [Project structure](https://docs.xeer.run/guides/project-structure.md): What `xeer new` writes, and what each file is for.

## Guides

- [Capabilities](https://docs.xeer.run/guides/capabilities.md): The powers an app declares, and why an undeclared one does not exist.
- [Server functions and the database](https://docs.xeer.run/guides/server.md): Queries, mutations, endpoints, and the typed table API.
- [Storage](https://docs.xeer.run/guides/storage.md): Private file storage per app: the `ctx.storage` surface, keys, browser uploads, limits, and what happens on deploy.
- [The client](https://docs.xeer.run/guides/client.md): Reading data with hooks, writing it with mutations, and staying in sync.
- [Live updates](https://docs.xeer.run/guides/live-updates.md): How every open client sees a change the moment it lands.
- [Auth](https://docs.xeer.run/guides/auth.md): Two separate identities: your builder account, and your app's own users.
- [Local development](https://docs.xeer.run/guides/local-development.md): The dev server, local data, and the personas that make authorization exercisable offline.
- [Testing](https://docs.xeer.run/guides/testing.md): The built-in test runner, and asserting authorization instead of assuming it.
- [Environment variables and secrets](https://docs.xeer.run/guides/env.md): Storing configuration per environment, and reading it from `ctx.env`.
- [Deploy, preview, promote, roll back](https://docs.xeer.run/guides/deploy.md): Shipping to a real URL, and the levers for changing what is live.
- [Building with AI agents](https://docs.xeer.run/guides/agents.md): The machine-readable surface: `--json` on every command, and the MCP server.

## Reference

- [CLI reference](https://docs.xeer.run/reference/cli.md): Every `xeer` command, its options, and what it does.
- [Manifest reference](https://docs.xeer.run/reference/manifest.md): Every field of `xeer.app.json`, with its exact rules.
- [Diagnostics reference](https://docs.xeer.run/reference/diagnostics.md): Every stable `XE####` code the compiler and CLI emit, what it means, and how to repair it.

- [FAQ](https://docs.xeer.run/faq.md): Access, infrastructure, limits, and the questions that come up first.