Documentation#

Globetrotter turns TOML translation catalogs into runtime JSON and generated language bindings. The CLI also formats and lints the source catalogs, so one tool owns the full translation build step.

Start here#

• Introduction — the design and when it is useful.
• Installation — install the globetrotter binary.
• Quick start — run the checked-in example and inspect its output.

Use globetrotter#

• Configuration — config discovery, inputs, languages, and output paths.
• Translation files — catalog structure, arguments, and key prefixes.
• Generated outputs — runtime JSON and generated bindings.
• Linting — built-in checks, source usage scanning, and LLM-assisted review.
• CLI reference — commands and shared options.
• Continuous integration — verify generated files and lint catalogs in CI.
• FAQ — common design and workflow questions.

The CLI and the version 1 YAML config are the primary user interfaces. The Rust crates expose the implementation for library users, but applications normally invoke the generator as a build step.