Overview
What it is
Tarot AI is an interactive, AI-powered tarot reading web application that combines traditional tarot symbolism with generative AI to deliver personalized interpretations. Users can ask questions, draw cards, and receive contextual readings based on their questions, selected cards, and card orientations.
Problem
The problem
Traditional tarot readings often require users to consult experienced readers or interpret complex card meanings themselves. While online tarot platforms offer greater accessibility, many rely on predefined interpretations that fail to consider the user's specific question or the relationships between drawn cards.
Approach
How I built it
I developed a full-stack web application that integrates an interactive tarot card experience with AI-powered interpretation. The approach focused on three key areas: creating an engaging user experience, generating context-aware interpretations through AI, and designing a secure architecture for handling AI requests.
- 1
Interactive Tarot Experience
Designed an interactive card-drawing experience using a complete 78-card tarot deck. Implemented randomized card selection, upright and reversed orientations, and animated card reveals to create an engaging reading experience.
- 2
AI-Powered Interpretation
Integrated GenAI API to generate personalized tarot interpretations. Developed structured prompts that incorporate the user's question, drawn cards, and card orientations to produce individual card analyses, combined interpretations, and actionable guidance.
- 3
Multilingual User Experience
Implemented localization support for Traditional Chinese, English, and Japanese, allowing users to navigate the application in their preferred language. Combined responsive layouts with interactive animations to provide a consistent experience across devices.
Frontend/Backend
Next.js
Generate Reading
GenAI
Tech
What I used
- Next.js
- React
- JavaScript
- HTML
- CSS
- Tailwind CSS
- Motion
- Git
Gallery


