Skip to main content

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.

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.
Prefer to keep translations in your Git repo? Use GitHub or GitLab integration instead.

How it works

  1. Push & pull files — Upload and download translation files using the API or the CLI (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 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

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, 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