Tarot Talk

Your cards, your story, beautifully told. A tarot card reading app that lets users either draw random tarot cards or input their physical card draws to receive AI-powered card interpretations and a cohesive narrative reading of the spread.

Visit Website
Client
N/A
Services
Web App
Tools
React, Node, Vercel
Work Main Image

Project overview

Inspiration

With the diverse and complex meanings behind any spread of cards which can be drawn, weaving a comprehensive and meaningful reading can be hard to come by. Inspired by my sister's tarot cards decorated with the surreal and beautiful artwork by Nicoletta Ceccoli, I wanted to provide a convenient and intuitive way to have your cards read.

After a few conversations about how to shape the experience and having the vision in full sight, I cracked open the laptop and got to work.


Tarot Talk

A tarot card reading app that lets users either draw random tarot cards or input their physical cards they've drawn to receive structured interpretations with a cohesive narrative. You may also click on a card to explore its meaning and characteristics in greater detail.

An example of a three-card spread.
The Empress presented in a details popup.

Intuitive and Comprehensive Readings

The heart of this tarot reading web app lies in its ability to deliver meaningful, personalized interpretations that resonate with users. Rather than relying on pre-written descriptions, the application harnesses the power of Google Gemini's large language model to generate dynamic, contextual readings that adapt to each unique card combination and spread. This approach ensures that every reading feels fresh and relevant, capturing the nuanced interplay between cards that traditional static interpretations often miss. The LLM integration allows for sophisticated analysis of card positions, relationships, and symbolic meanings, creating readings that feel both authentic and insightful.

To enhance the user experience, careful attention was paid to formatting the output with clean typography, intuitive spacing, and visual hierarchy that makes complex interpretations easy to digest and contemplate.

Seamless Navigation Through Progressive Disclosure

The user journey begins with a simple but crucial question that immediately personalizes the experience: whether they've already drawn physical cards or prefer a random digital selection. This progressive disclosure approach prevents overwhelming new users while accommodating those who want to input their own spreads.

For users choosing manual card selection, the interface transforms into a powerful yet elegant filtering system that makes navigating the 78-card tarot deck effortless. Smart filters allow users to quickly narrow their search by major or minor arcana, or searching cards by their name, turning what could be a tedious browsing experience into an intuitive exploration. The custom spread builder emerges naturally from this flow, enabling users to construct their preferred layouts card by card.