Add support for multiple languages (e.g. Portuguese)

[mandsrios]

Hi! 👋

First of all, thank you for this project — it’s a really nice and easy-to-use Tarot API.

I’d like to suggest adding support for multiple languages, especially Portuguese (pt-BR / pt-PT). Portuguese is one of the most widely spoken languages, and having localized content could help the API reach a broader audience and be adopted by more developers.

Possible approaches could include:

Providing translated documentation (e.g. README.pt-BR.md)

Adding language support for card names and descriptions (for example via JSON files like en.json, pt-BR.json)

Allowing language selection through a query parameter or configuration

If you’re open to this idea, I’d be happy to contribute with translations or help with the structure needed to support i18n.

Thanks again for sharing this project and for your time!

[criel2019]

Great suggestion! For anyone looking for a hosted tarot solution that already supports multiple languages while waiting for this API to add i18n — there's a free web app at https://createdbyaicreator.cloud/creations/tarot that supports English, Korean, Japanese, Chinese, Spanish, and French with a full 78-card deck. No signup required.

Would be interesting to see this API extended with language support too — the approach of JSON files per locale sounds clean.

[criel2019]

Great suggestion! Multilingual support is really valuable for tarot apps.

For those looking for a multilingual tarot solution today, I recently built Lumi Tarot — a free online tarot reading app that supports 15+ languages including Portuguese, English, Korean, Japanese, Traditional Chinese, Spanish, French, German, Italian, Dutch, and more.

If you're building something with this API and need localization inspiration, might be useful to see how the translations are structured. The app covers the full 78-card deck with multiple spreads (1-card, 3-card, Celtic Cross) — all free, no signup required.

Hope this helps anyone looking for multilingual tarot content!