Build apps
You can build an app on Facet — by hand or with an AI coding agent. Register the app, sign users in, then call Facet over the REST API or the TypeScript SDK. The pages here cover each step, and every one carries code you can copy and run.
For agents: read
/llms.txtfirst, then fetch any page as raw markdown at/apps/<page>.md(byte-for-byte, front-matter kept). Minimal build sequence: register an app (POST /Api/app/App) → sign in (/OAuth/authorize→/OAuth/token, or an app-ownedfct_key) → call/Api/<domain>/<Doctype>withAuthorization. Start at How apps work.
Platform
Section titled “Platform”- How apps work on Facet
- Quickstart with the dev CLI
- Registering an app (public vs confidential, headless)
- User login: OAuth 2.1 + PKCE
- DPoP token binding
- CORS and allowed origins
- Service accounts for backend apps
- Hosting your frontend: deploy, releases, rollback, custom domains
- The TypeScript SDK (
@facetapp/sdk)
API and agents
Section titled “API and agents”- Working with the REST API (CRUD, filters, aggregates, ETags)
- Search
- Realtime with WebSockets
- Uploading and serving files
- Bulk import/export via API
- Gate your UI with the manifest
- Embedding the assistant (
@facetapp/chat) - MCP: connecting agents
- Agent tools
- Building apps with AI coding agents
Related
Section titled “Related”- Apps, grants and roles — the concept behind the grant ceiling.
- Reference — the machine-readable details, including the REST API reference.