Skip to content

Localization Status ​

This is a living planning document. Re-audit the current nightly branch before implementing localization work.

This file tracks UI i18n wiring and known remaining localization work. It does not guarantee translation completeness for every individual locale.

The supported UI locale set is en, fr, de, es, pt-BR, it, ja, pl, nl, and ru. English is the source catalog; French is currently complete, German and Spanish are partial overlays, and the six newly registered locales are partial overlays that fall back to English.

Status Meaning ​

StateMeaning
i18n-enabledThe UI area is wired into an i18n system. This does not mean every locale is fully translated.
PartialSome UI chrome is i18n-enabled, but notable rendered UI remains hardcoded or unaudited.
Mostly hardcodedMost rendered UI chrome is not yet wired into the localization system.
Maintainer decisionLocalization may need a namespace, architecture, behavior, or scope decision before implementation.

Current i18n Coverage ​

This table describes broad UI i18n wiring and known remaining work. It does not claim backend messages, user data, external metadata, configured values, or provider content are localized. The Maintenance/Cleaner rules workflow is covered in a focused batch; the wider dashboard remains Partial.

AreaState
Primary portal navigationi18n-enabled
Discover / Request member UIi18n-enabled
Home / Wrap-Upi18n-enabled
In-app notification chromei18n-enabled
Achievementsi18n-enabled (feature-local catalog)
Status Monitor settingsi18n-enabled
Achievements settingsi18n-enabled
Invites settingsi18n-enabled
Settings navigation / tabsi18n-enabled
Overlays dashboardi18n-enabled
Downloads pagei18n-enabled
Media Stack Calendari18n-enabled
Status pagei18n-enabled
Support ticketsi18n-enabled
Wider SettingsPartial
Scanneri18n-enabled
ColleXionsPartial
Media AutomationPartial
Poster SetsPartial
Library UpgraderPartial
Requests admin UIPartial
Maintenance / Cleaneri18n-enabled
Abouti18n-enabled
Logsi18n-enabled
Setup/admin utility areasMostly hardcoded

These batches are planning guidance only. Recalculate collision risk from recent nightly history before starting work.

BatchApproximate scopeRecommended namespaceSizeArchitecture risk
Settings navigation / tabsSettings navigation, tab labels, and navigation-order settings chromesettings.navigation.*MediumMedium
Major primary pages / recurring actionsHigh-traffic page headings, buttons, empty states, and repeated action chromeUse existing feature namespaces where availableMediumMedium
Feature-specific settings wrappers and secondary modulesSmaller settings wrappers such as Overlays, Poster Sets, Scanner, ColleXions, and Library Upgradersettings.overlays.*, settings.posterSets.*, settings.scanner.*, settings.collexions.*, settings.upgrader.*Small / MediumLow / Medium

Larger Future Areas ​

Large modules should be decomposed into reviewable sub-batches rather than one huge translation PR.

Future candidates include:

  • Scanner dashboard
  • ColleXions module
  • Media Automation module
  • Poster Sets module
  • Library Upgrader module
  • Requests admin UI
  • Maintenance / Cleaner
  • About / Logs
  • setup/admin utility areas

Architecture / Maintainer Decision Backlog ​

These areas should be re-audited and may need maintainer confirmation before localization:

  • Settings search/index metadata
  • setup wizard flows where localization may require broader structural decisions

Treat these as candidates for review, not permanent blockers.

Locale-Specific Status ​

French source/catalog parity was healthy at the latest global audit. No known missing keys, extra keys, or placeholder mismatches were found at that time.

German, Spanish, and other locales must be audited independently unless their current completeness has been verified against the latest source catalog.

Updating This File ​

Update this file when a localization PR materially changes:

  • module i18n coverage
  • roadmap status
  • architecture decision status

Do not use this document as a changelog. Do not include PR history, personal notes, local paths, branch or stash history, exact temporary SHAs, exact volatile catalog counts, or detailed audit history.

Built for the self-hosting community.