How it works
- Push & pull files — Upload and download translation files using the API or the CLI (
prismy push/prismy pull). - Prismy hosts the files — Translations live in Prismy; no need to store them in your repository.
- Configure in Prismy — In the Prismy Hosted config you set up repositories and bundles (e.g. which languages, which file structure).
- 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 | prismy push |
| Download a file | Get Translation File | prismy pull |
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.
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.
Next steps
- CLI: push & pull — Install the CLI, authenticate, and run
prismy push/prismy pull(including CI examples). - API Reference: Prismy Hosted — GET and UPDATE endpoints for integration from your own code.