Skip to content

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

Description

@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!

Activity

  1. criel2019 commented on Apr 18, 2026

    @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.

  2. criel2019 commented on Apr 18, 2026

    @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!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions