# Platform

The Comvi web app and REST API: where translations are authored, and the CDN and CLI that deliver them to your apps.

Canonical: https://comvi.io/docs/platform

The Comvi platform is the web app at [app.comvi.io](https://app.comvi.io) where you manage
keys, languages and translations, plus the REST API behind it. Production apps read
translations from the CDN at runtime or bundle them at build time with the [CLI](/docs/cli)
or an [export](/docs/platform/import-export); the REST API is for authoring, automation and
dev tooling, not for production reads.

## How it fits together

<Mermaid
code={`flowchart LR
    subgraph Manage["Manage"]
      Dashboard["Comvi dashboard"]
      ICE["In-Context Editor"]
      APIin["REST API (push)"]
      CLIin["CLI (push)"]
    end

    Platform["Comvi Platform"]

    subgraph Deliver["Deliver"]
      CDN["CDN<br/>(runtime fetch)"]
      CLIout["CLI pull<br/>(build-time bundle)"]
    end

    Apps["Your apps"]
    Your["Your systems<br/>(CI, Slack, ...)"]

    Dashboard --> Platform
    ICE --> Platform
    APIin --> Platform
    CLIin --> Platform
    Platform -- deploy --> CDN
    Platform --> CLIout
    Platform -- events --> Your
    CDN --> Apps
    CLIout --> Apps
`}
caption="Author on the left, deliver on the right. Apps read from the CDN at runtime or bundle translations at build time; webhooks push events to your own systems."
/>

## Start here

- [Your first project](/docs/platform/your-first-project): Create a project, add languages and keys, translate, and get a live CDN URL. No app code.
- [Connect your app](/docs/i18n/connect-comvi): Point the Comvi i18n library at the CDN endpoint and ship a wording change without a redeploy.
- [Consume translations](/docs/platform/consume-translations): Load the JSON bundles into any app or runtime, with or without the Comvi i18n library.
- [Core concepts](/docs/platform/concepts): Projects, languages, keys, namespaces, statuses and API keys, and how they relate.

## Sections

- **Content**: [Projects](/docs/platform/projects), [Languages](/docs/platform/languages), the [Translations](/docs/platform/translations) editor, the [translation lifecycle](/docs/platform/translation-lifecycle), [Namespaces](/docs/platform/namespaces) and [Import & export](/docs/platform/import-export).
- **Delivery**: [Content Deploy and the CDN](/docs/platform/cdn), and [API keys](/docs/platform/api-keys) for the CLI and automation.
- **Quality**: [Machine translation](/docs/platform/machine-translation), [AI context](/docs/platform/ai-context), [Translation memory](/docs/platform/translation-memory) and [Glossaries](/docs/platform/glossaries).
- **Team**: [Team management](/docs/platform/team-management) and [Roles & permissions](/docs/platform/roles-permissions).
- **Integrations**: [Webhooks](/docs/platform/integrations/webhooks).
- **Recipes**: [translator and reviewer workflow](/docs/platform/recipes/translator-review-workflow), [staging to production](/docs/platform/recipes/staging-production), [CI/CD](/docs/platform/recipes/ci-cd-integration), [scaling to 20 languages](/docs/platform/recipes/scaling-languages), [monorepo namespaces](/docs/platform/recipes/monorepo-namespaces), [migrating an existing project](/docs/platform/recipes/migrating-large-project) and [onboarding agencies](/docs/platform/recipes/onboarding-agencies).