Interactive tarot game · HackCMU 2025

Tarocchi

A tarot game that turns a personal question into an illustrated adventure, with a reading shaped by the cards and choices along the way.

Tarocchi pixel-art oracle prompt
Tarocchi in production
ILLUSTRATED SETTINGS5
READING SPREADS3
TAROT CARDS78

Role

Front-end engineer and interaction designer

Challenge

What had to be solved

The idea was to make a tarot reading feel like a short game, with room to explore before seeing the cards. The final interpretation needed to connect the player’s question and choices to the drawn spread.

Approach

How I built it

  1. Used a React reducer to manage the spread, shuffled scene order, and player choices from the opening prompt through the result.
  2. Combined Sarah Seekins’s 78-card PixelTarot deck with five illustrated settings, CSS parallax, particle effects, and optional looping music.
  3. Passed the question, choices, and drawn cards through an Express backend to Claude. The cards are random, while the player’s answers give the interpretation its context.

Outcomes

What changed

React & Vite TypeScript Tailwind CSS CSS animation Claude API Express