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

Reference

The lookup page: exact values, no prose. For the ideas behind them, see Concepts.

Repo settings

Setting Values Default
framework elixir (gettext) · formatjs (JSON) · rails (YAML, private beta) elixir
scan_mode selected · all selected
scan_branch_regex regex string —
required_locales list of locales [] (gate inactive)
gate_scope incremental · whole_catalog incremental
gate_fuzzy warn · block warn
translation_mode suggest · autofill_submit · autofill_approve suggest
auto_translate_on_scan boolean false
quality_gate off · warn · block off
quality_blocking_severity critical · major critical
quality_locales list of locales [] (falls back to required_locales)
quality_model model override string —

All settings live in the project’s Settings page and are enforced with database constraints — there is no config file to commit. (The app calls a repository a project.)

Roles & permissions

Organization roles: owner, admin, member.

Capability owner admin member
billing, delete org ✓ — —
manage org, connect repos ✓ ✓ —
team work ✓ ✓ ✓

Team roles: owner, admin, developer, reviewer, translator, viewer. Repos belong to a team; repo access is team membership — there are no separate repo-level roles.

Capability owner admin developer reviewer translator viewer
view ✓ ✓ ✓ ✓ ✓ ✓
edit translation ✓ ✓ ✓ ✓ ✓ —
submit for review ✓ ✓ ✓ ✓ ✓ —
review ✓ ✓ ✓ ✓ — —
assign work ✓ ✓ ✓ ✓ — —
structural edit, rename msgid ✓ ✓ ✓ — — —
open PR, bulk operations ✓ ✓ ✓ — — —
manage team ✓ ✓ — — — —

A translator membership can be scoped to specific locales (empty scope = all locales). Locale scoping applies to editing; a scoped check without a locale fails closed. Last-owner protection applies everywhere: the only owner of an org or team can’t be removed or demoted.

Supported PO constructs

The engine parses your files and splices edits into the original bytes — it never regenerates a file. Preserved verbatim across edits:

  • multi-line (wrapped) strings
  • plural entries (msgid_plural, msgstr[N] — plural count read from the catalog’s own Plural-Forms: header, which is never rewritten)
  • msgctxt (entries are keyed by context + msgid)
  • translator comments (#), extracted comments (#.), references (#:), flags (#,), previous-msgid markers (#|), obsolete entries (#~)
  • blank lines and file ordering

Parsing is strict: a malformed catalog rejects its whole scan (HTTP 422) rather than being half-ingested.

Supported JSON shapes

Edits are spliced into the original bytes here too. Supported layouts (catalog_layout: auto · flat · tree · extension, detected under auto):

  • Flat. One <locale>.json object per locale, with ICU messages.
  • Nested. Key trees (i18next, next-intl, vue-i18n), with a configurable key separator.
  • Browser extension. _locales/<locale>/messages.json, with message, description and $name$ placeholders.

See the JSON guide.

Limits

Limit Value
Template files per scan 1,000
Single template file 5 MB
Scan request body 20 MB
Code snippets per scan 50,000
Scan uploads 30 requests / minute / IP
MCP calls 30 requests / minute / IP
MCP list_untranslated page 500 entries
MCP token validity 365 days
Hosted translation free allowance 250,000 source characters per user account, one time
Voice: lexicon terms per profile 50
Voice: exemplar strings per profile 20
Voice: website scan 6 pages / 50,000 chars
Voice: uploaded source 10 MB in, 50,000 chars extracted
Voice card token budget ~400 tokens
Quality findings shown per check run 50