A modern web application built with React and TypeScript that provides AI-powered tarot card readings using Google's Gemini AI.
Overview
Mystic Tarot Reading offers an immersive digital tarot reading experience, combining traditional tarot wisdom with modern AI interpretation. Users can ask questions, receive personalized three-card readings, and engage in follow-up conversations about their readings.
Key Features
Interactive Card Selection: Draw three cards from a beautifully designed digital tarot deck
AI-Powered Readings: Get detailed interpretations of your cards using Google's Gemini AI
Personalized Experience: Ask specific questions and receive tailored readings
Chat Interface: Engage in follow-up discussions about your reading
Reading History: Save and revisit your past readings
Responsive Design: Seamless experience across desktop and mobile devices
Technical Stack
Frontend: React 18 with TypeScript
Styling: Tailwind CSS
AI Integration: Google Generative AI (Gemini)
State Management: React Hooks
Build Tool: Vite
Markdown Support: React Markdown with remark-gfm
Prerequisites
Node.js 18.x or higher
npm 9.x or higher
A Google Gemini API key
Getting Started
Clone the repository
Install dependencies with npm install
Add your Gemini API key to .env
Start the development server with npm run dev
For detailed setup instructions, see the Installation section below.