Contributing

Local development

git clone https://github.com/IEvangelist/resource-translator
cd resource-translator
npm install
npm run verify   # lint + format:check + test + build

Adding a parser

1. Add a fixture under __tests__/data/.
2. Implement TranslationFileParser (parse, format, applyTranslations, toTranslatableTextMap).
3. Register it in translation-file-parser-factory.ts.
4. Add the file extension to translationFileSchemes in translation-file-finder.ts.
5. Write round-trip tests for parse → format and applyTranslations.

Coverage thresholds

The Jest config enforces minimum coverage. New code must keep the statements + lines threshold above 78% and functions above 90%. Add fixtures and tests alongside your change.

Documentation site

The docs/ folder is an Astro 6 + Tailwind v4 project. Run npm install there once, then npm run dev for local preview. The pages.yml workflow ships docs to GitHub Pages on every merge.