> ## Documentation Index
> Fetch the complete documentation index at: https://docs.prismy.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Prismy Hosted — translations in the cloud

> Host translation files in Prismy and serve them via CDN

Use **Prismy Hosted** when you don't want to plug Prismy into GitHub or GitLab. Prismy stores your translation files; you push and pull via **API** or **CLI**, and your app can use **CDN-hosted** versions that update automatically when you change content.

<Note>
  Prefer to keep translations in your Git repo? Use [GitHub](/tech/github) or [GitLab](/tech/gitlab) integration instead.
</Note>

## How it works

1. **Push & pull files** — Upload and download translation files using the [API](/api-reference/prismy-hosted/update-translation-file) or the [CLI](/tech/cli/prismy-hosted) (`prismy push` / `prismy pull`).
2. **Prismy hosts the files** — Translations live in Prismy; no need to store them in your repository.
3. **Configure in Prismy** — In the [Prismy Hosted config](https://app.prismy.io) you set up **repositories** and **bundles** (e.g. which languages, which file structure).
4. **CDN-hosted versions** — Each time files are updated, Prismy publishes a CDN-hosted version. You can use that URL directly in your app to load the latest translations (e.g. at runtime or build time).

## Push and pull: API or CLI

| Action              | API                                                                             | CLI                                                  |
| ------------------- | ------------------------------------------------------------------------------- | ---------------------------------------------------- |
| **Upload a file**   | [Update Translation File](/api-reference/prismy-hosted/update-translation-file) | [`prismy push`](/tech/cli/prismy-hosted#prismy-push) |
| **Download a file** | [Get Translation File](/api-reference/prismy-hosted/get-translation-file)       | [`prismy pull`](/tech/cli/prismy-hosted#prismy-pull) |

Use the CLI for local dev or CI; use the API when you need to integrate from your own backend or scripts.

## Configure repos and bundles

In the **Prismy Hosted** section of your [Prismy dashboard](https://app.prismy.io), you define:

* **Repositories** — One per project or app.
* **Bundles** — Groups of translation files (e.g. by feature or locale). Each bundle has a name and language settings.

Once configured, use the same `repo_id` and `bundle-name` in your API calls or CLI commands.

## CDN-hosted files

When you update a translation file (via API or CLI), Prismy updates the hosted copy and refreshes the **CDN URL** for that file. You can:

* Use the CDN URL in your app to fetch the latest JSON (or other format) at runtime.
* Or pull files in CI with the CLI and commit them to your repo—your choice.

The CDN URL is available in your Prismy Hosted configuration in the dashboard.

## Next steps

* [CLI: push & pull](/tech/cli/prismy-hosted) — Install the CLI, authenticate, and run `prismy push` / `prismy pull` (including CI examples).
* [API Reference: Prismy Hosted](/api-reference/prismy-hosted/get-translation-file) — GET and UPDATE endpoints for integration from your own code.