spotiarr-i18n

Enforce i18n key synchronization and language sync rules for SpotiArr frontend.

41|6|Updated Nov 27, 2025
One-click install
npx skills add https://github.com/mralexsaavedra/spotiarr --skill spotiarr-i18n
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spotiarr-i18n
Source: https://github.com/mralexsaavedra/spotiarr/tree/main/skills/spotiarr-i18n
Command: npx skills add https://github.com/mralexsaavedra/spotiarr --skill spotiarr-i18n

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill prevents missing or inconsistent localization keys in the SpotiArr frontend by enforcing how languages, i18n resources, and key conventions are maintained.

Core Features & Use Cases

  • Language synchronization via backend setting: Ensures UI language follows the UI_LANGUAGE backend configuration using useLanguageSync rather than ad-hoc browser detection or manual language switching.
  • Safe translation handling: Locks escapeValue: false expectations so translation strings can include HTML without accidental escaping, while warning against untrusted content.
  • Translation-key discipline: Standardizes dot-notation keys and interpolation usage, and requires adding new keys across all locale files to avoid silent fallbacks.

Quick Start

Update SpotiArr’s frontend by adding your new translation keys in both en.json and es.json, then follow the key conventions used in src/locales while relying on UI_LANGUAGE for language switching.

Frequently Asked Questions about spotiarr-i18n

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I keep i18n translation keys consistent across multiple locale files?

To keep i18n translation keys consistent, you must synchronize new keys across all locale files like en.json and es.json using standardized dot-notation paths. This prevents silent fallbacks and missing string errors during frontend localization.

Why are my HTML tags disappearing in i18next translation strings?

Your HTML tags are disappearing because the i18next configuration uses escapeValue: false. This policy allows translation strings to include HTML without accidental escaping, though you should avoid using untrusted content to prevent security issues.

How do I sync the frontend UI language with backend settings in i18next?

You sync the UI language by using the useLanguageSync hook to follow the UI_LANGUAGE backend configuration. This enforces reliable language synchronization instead of relying on ad-hoc browser detection or manual language switching.

What happens if I add a new i18n key to only one locale file?

If you add a new i18n key to only one locale file, the application will experience silent fallbacks or missing translations. You must enforce synchronized key updates across all locale files to maintain correct internationalization behavior.

What key-path conventions should I follow when adding i18next translations?

You should follow standardized dot-notation key paths and specified interpolation conventions when adding i18next translations. Maintaining this translation-key discipline ensures structured localization and prevents silent fallbacks across locale resources.