Soft launchDialecto is still in testing, and details on this site may change as we finish it.

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.