Documentation
How Dialecto works, written down for the product as it is built today. New here? Start with getting started.
Dialecto is in a soft launch, so details may still change as we finish it. Accounts are open: sign up free and follow these pages with your own repository.
Start
- Getting started
From a connected repo to your first minimal-diff pull request: connect, scan, edit by domain, ship.
Understand
- Concepts
The model behind Dialecto: repo as source of truth, the editable index, domains, the surgical slice, minimal diffs, and the review lifecycle.
Guides
- Elixir / Phoenix
The first-class guide: setup, scanning, editing, the merge gate, and call-site rewrites for a Phoenix app.
- JSON / JavaScript
JSON message catalogs: the shapes Dialecto edits, how edits ship as minimal diffs, and the in-context editor for Astro.
- Apple / Swift
Apple String Catalogs: how a renamed key changes the Swift code that reads it, in the same pull request.
- WordPress / PHP
Where WordPress-gettext support stands today, and what already works.
- Django / Python
Django gettext catalogs in Dialecto: the scan, the usage check, and live editing on your running app.
- Phoenix live editing
Click any translated text on your running Phoenix app, edit it in the Dialecto sidebar, and open a pull request against your gettext files.
- Rails live editing
Click any translated text on your running Rails app, edit it in the Dialecto sidebar, and open a pull request against your locale files.
- Astro live editing
Click any text on your running Astro site, edit it in the Dialecto sidebar, and open a pull request against your JSON catalogs.
- Next.js live editing
Click any text on your running Next.js app, edit it in the Dialecto sidebar, and open a pull request against your message files.
- Vite live editing
Click any text in your running React or plain Vite app, edit it in the Dialecto sidebar, and open a pull request against your JSON catalogs.
- Vue/Nuxt live editing
Click any text in your running Vue or Nuxt app, edit it in the Dialecto sidebar, and open a pull request against your vue-i18n catalogs.
- Svelte live editing
Click any text in your running SvelteKit app, edit it in the Dialecto sidebar, and open a pull request. Works with Paraglide and svelte-i18n.
- Angular live editing
Click any text in your running Angular app, edit it in the Dialecto sidebar, and open a pull request. Works with ngx-translate and Transloco.
- Django live editing
Click any translated text on your running Django app, edit it in the Dialecto sidebar, and open a pull request against your .po files.
Connect
- GitHub App
How Dialecto connects to GitHub: Convenience mode with the GitHub App, Security mode with your own workflow, and the personal-access-token fallback.
- Scanning & CI
The scan contract: one authenticated HTTP call from your CI carrying your catalogs and code snippets, and nothing else.
- Coding agents (MCP)
Connect Claude Code, Cursor or any MCP client to Dialecto with a token you make in your settings, and your agent stages translations and opens the pull request as you.
Workflow
- The merge gate
The Dialecto/translations completeness check and the advisory Dialecto/quality check on your pull requests.
- Translation aids
Machine translation on your own machine, through DeepL (EU) or through Gemini (Google, US), autofill modes, translation memory, and the glossary, all review-gated.
- Context & personas
Curated AI context: the brand-voice profile, audience personas, and the token-budgeted voice card that grounds every suggestion.
- Source call-site rewrite
Renaming a msgid rewrites the gettext() call-sites in your source — computed by Dialecto, applied in your repo.
- Live-site editing
Let approved people fix copy and review translations on your running Phoenix or Rails site, with edits going through review and a pull request.
Operate
- API & MCP
Dialecto's programmatic surface: the scan API, the MCP server for editors and agents, and the GitHub webhook.
- Self-hosting
Run Dialecto on your own metal: the stack, every environment variable, and the local-model setup.
Reference
- Reference
Repo settings, roles and permissions, supported PO and JSON constructs, and every limit — the lookup page.
- Troubleshooting
The failure modes you'll actually hit, and what each one means.