# Yalla Docs

> Agent-first documentation for deploying and operating services with Yalla Runtime and the Yalla Deploy Engine. Every human page has a clean Markdown mirror and is aggregated into machine-readable context bundles.

Read the linked Markdown files directly instead of scraping HTML. Parse the yalla.output.v1 and yalla.error.v1 envelopes, branch on stable error codes rather than human messages, and surface request_id on every failure.

## Get started
- [Quickstart](/docs/quickstart.md): Install the CLI, authenticate, and ship your first service in minutes.

## CLI and agents
- [CLI commands](/docs/cli.md): Install the Yalla CLI and learn the commands agents use most.
- [Agent skills and local workflow](/docs/agent-skills.md): Pair a coding agent with the CLI and install Yalla agent skills.

## API reference
- [Manifest schema](/docs/manifest-schema.md): The yalla.toml fields that describe projects, environments, and services.
- [API envelopes](/docs/api-envelopes.md): The yalla.output.v1 and yalla.error.v1 envelopes every response uses.
- [Error codes](/docs/error-codes.md): Stable error codes, what they mean, and whether a retry is safe.

## Operate
- [Deployment recipes](/docs/deploy-recipes.md): Common deploy, promote, and rollback flows for agents and humans.
- [Control-plane flows](/docs/control-plane.md): Operate services visually with the topology canvas, inspector actions, and the timeline.
- [Logs and metrics](/docs/logs-metrics.md): Stream service logs, read metrics, and trust honest unavailable states.
- [Domains](/docs/domains.md): Attach custom domains to a service, verify DNS, and get managed TLS.
- [Backups](/docs/backups.md): Create, schedule, and restore backups for database services.
- [Usage and billing visibility](/docs/billing.md): See usage, limits, and invoices; the backend stays the quota authority.
- [Troubleshooting](/docs/troubleshooting.md): Diagnose failed deploys and stuck jobs with the request_id as your key.

## Security and trust
- [Security boundaries](/docs/security.md): What Yalla never exposes, and how secrets and tokens are handled.
- [Support escalation](/docs/support.md): Escalate issues with the request_id, the error code, and the right severity.