# Rodarion

> Translation management for software projects, built to be set up by an AI coding agent. Source strings stay in the repository; Rodarion stores the keys, fills missing translations with machine translation, tracks review status, and syncs the results back into the language files through a CLI and a REST API. Free up to a generous key limit, no credit card.

If a human asked you to set up Rodarion, or to add translation management to a repository, start with the first link. It needs no account: you create a free trial yourself and only ask the human for an e-mail address at the end.

## Start here

- [Set up Rodarion in this repository](https://www.rodarion.com/llms/start.md): the goal, the order of work, the rules and the hand-off to the human.
- [Pricing and limits](https://www.rodarion.com/llms/pricing.md): plans, the free key limit, trial limits.

## Reference

- [CLI](https://www.rodarion.com/docs/cli.md): Install the rodarion CLI, configure rodarion.json and .env, and sync language files with upload, download and migrate.
- [REST API](https://www.rodarion.com/docs/api.md): Authentication with scoped tokens, the endpoints for keys and translations, and the public endpoints for signup and trials.
- [Branch workflow](https://www.rodarion.com/docs/branch-workflow.md): Feature branches get an isolated shadow project, so unfinished strings never reach the shared project until the branch is merged and promoted.
- [CI](https://www.rodarion.com/docs/ci.md): Scaffold a workflow that promotes merged branches and commits the refreshed language files, or downloads approved translations for a release.
- [Formats](https://www.rodarion.com/docs/formats.md): Supported file formats, layouts and placeholder styles, with recipes for Laravel, i18next, Android and iOS.
- [How agent setup works](https://www.rodarion.com/docs/agents.md): The document chain an AI coding agent follows to set up Rodarion, what each part owns, and what the agent will and will not do.

## App and API (app.rodarion.com)

- [App llms.txt](https://app.rodarion.com/llms.txt): the application's own index.
- [Trial provisioning guide](https://app.rodarion.com/llms/trial.md): create a trial, install and configure the CLI.
- [Locale catalogue](https://app.rodarion.com/api/public/locales): valid locale codes (no auth).

## Optional

- [Human start page](https://www.rodarion.com/start): what the human sees and the prompt they pasted.
- [FAQ](https://www.rodarion.com/faq)