How to Contribute

Option 1: GitHub (Recommended)

Translations live in the app/src/main/res/values-*/strings.xml files in our GitHub repository. To contribute:

1. Fork the Jackie's List repository
2. Find the values-XX/strings.xml file for your language (e.g. values-es for Spanish)
3. Translate any missing strings, keeping the name attributes unchanged
4. Submit a pull request with your changes

Option 2: Add a New Language

Want to add a language we don't support yet? Great!

1. Copy the values/strings.xml (English) file
2. Create a new folder named values-XX using the ISO 639-1 code for your language
3. Translate all strings into your language
4. Submit a pull request

Option 3: Report an Issue

Spot a translation error? Open an issue describing what's wrong and we'll fix it.

Translation Guidelines

• Keep placeholders like %1$s and %1$d intact — they're replaced with values at runtime
• Preserve any HTML tags (<b>, <i>) in the strings
• Use natural, conversational phrasing — not word-for-word translation
• Keep the same tone: friendly, clear, and helpful
• Test your translations if possible by building the app locally

Thank You

Every translation helps someone use Jackie's List in their own language. Contributors will be credited in the app's About section. 💚