# BrandApp SDK Developer Resources — BrandApp Playground

> Named index of every developer resource: API reference, OpenAPI description, auth docs, webhooks, and the SDK package.

- Canonical page: https://brandapp-playground.vercel.app/docs
- Markdown: https://brandapp-playground.vercel.app/docs.md
- SDK module: `@reopt-ai/brandapp-sdk`

## Machine-readable resources

| Resource | URL |
| --- | --- |
| BrandApp Playground OpenAPI description | `/openapi.json` |
| Documentation index for agents (llms.txt) | `/llms.txt` |
| Full documentation, single file | `/llms-full.txt` |
| API catalog (RFC 9727) | `/.well-known/api-catalog` |
| Route inventory | `/sitemap.xml` |
| Markdown twin of any page | append `.md`, or send `Accept: text/markdown` |

## Documentation by topic

- **Getting started** — install, credentials, first call: `/getting-started`
- **Authentication** — Better Auth + Reopt OAuth, scopes, single logout: `/auth`
- **EAV** — entities, records, filter DSL, schema, migrations: `/eav`
- **AI** — text, images, the Vercel AI SDK provider, credits: `/ai`
- **CMS** — posts, groups, tags, sitemap and RSS helpers: `/cms`
- **Files** — folders, uploads, previews, storage usage: `/files`
- **Webhooks** — signature and replay verification: `/webhooks`
- **Errors** — error classes and the diagnostic payload: `/errors`
- **Dev server and testing** — offline development: `/dev-server`, `/testing`

## Package

`@reopt-ai/brandapp-sdk` on npm — MIT, public registry, no auth token required:
<https://www.npmjs.com/package/@reopt-ai/brandapp-sdk>

## Authentication model

This deployment is an OAuth **relying party**, not an authorization server.
The authorization server is Reopt ID, and its metadata is published at
<https://id.reopt.ai/.well-known/openid-configuration>. `/openapi.json` names the
scopes each user-scoped operation requires.

## Related

- [Quick Start](https://brandapp-playground.vercel.app/getting-started.md)
- [Authentication](https://brandapp-playground.vercel.app/auth.md)
- [Error Handling](https://brandapp-playground.vercel.app/errors.md)

---

Index of every document: https://brandapp-playground.vercel.app/llms.txt
Single-file copy: https://brandapp-playground.vercel.app/llms-full.txt
HTTP API description: https://brandapp-playground.vercel.app/openapi.json