Skip to content

ctrlaltjakub/Toth-Tarot-Handbook

Repository files navigation

Thoth Tarot Handbook

React 19 TypeScript Vite 7 Catppuccin

An interactive, open-source encyclopedia of the Thoth Tarot system.

License PRs Welcome

ko-fi


The Thoth Tarot is not a standalone system — it is the meeting point of three ancient traditions. The 78 cards are mapped onto the Kabbalistic Tree of Life, where the 22 Major Arcana correspond to the 22 paths and the 40 pip cards sit on the 10 Sephiroth. Each card also carries an astrological attribution — zodiac signs, planets, and elements — creating a web of correspondences where every symbol illuminates every other. This handbook maps all three systems together, with Jungian psychological interpretation as a fourth lens.

Screenshots

Interactive zodiac wheel with planets, signs, and decans
Interactive zodiac wheel — every sign, planet, and decan links to its tarot attribution
Card detail page for The Fool
Card detail page with cross-linked Hebrew letter, astrology, and Tree of Life path

Features

Note

Every term, card, sign, and symbol is cross-linked — click anything to explore its connections.

  • Tarot — All 78 cards (Major Arcana, Court Cards, pip cards) with visual, esoteric, and Jungian descriptions
  • Tree of Life — Interactive SVG diagram of the 10 Sephiroth and 22 paths with click-to-explore panels
  • Astrology — Zodiac wheel with decans, elements, qualities, planetary rulerships, and SVG-rendered planet glyphs
  • Library — Reference articles on history, methods, and foundational knowledge
  • Glossary — 285+ cross-linked terms with stack-based navigation and auto-linking across all descriptions
  • SearchCtrl+K instant search across cards, signs, planets, sephiroth, and glossary terms
  • Mobile-first — Responsive design with auto-detected diagram modes, bottom navbar, and keyboard-aware search

A Note on Card Imagery

The original Thoth Tarot deck paintings by Lady Frieda Harris remain under copyright (held by Ordo Templi Orientis), so this handbook does not reproduce the card images. Instead, each card is described through its visual symbolism, esoteric attributions, and Jungian interpretation — encouraging you to study the deck itself alongside the text.

Themes

Three Catppuccin dark palettes, switchable from Settings: 🌿 Mocha · 🌺 Macchiato · 🪴 Frappe

Getting Started

# Clone the repository
git clone https://github.com/ctrlaltjakub/Toth-Tarot-Handbook.git
cd Toth-Tarot-Handbook

# Install dependencies
npm install

# Start development server
npm run dev

The app will be available at http://localhost:5173/

Tech Stack

Layer Technology
Framework React 19
Language TypeScript
Build Vite 7
Styling CSS custom properties + Catppuccin
Diagrams Inline SVG (Tree of Life, Zodiac Wheel)
Planet Glyphs Custom SVG paths (cross-platform consistent)
Animations Framer Motion
Routing React Router
Icons Lucide React + custom SVGs
Hosting Vercel

Project Structure

src/
├── components/     # Reusable UI — diagrams, glossary, navbar, search, planet glyphs
├── contexts/       # Theme provider (palette + diagram mode)
├── data/           # All content — tarot cards, astrology, tree, glossary, library
├── pages/          # Route pages — Home, Tarot, Astrology, TreeOfLife, Library
├── styles/         # Global CSS with Catppuccin tokens
└── utils/          # Auto-glossary linker, card auto-linker, symbol formatting

License

MIT — free to use, modify, and distribute. Just keep the copyright notice.

About

An interactive, open-source encyclopedia of the Thoth Tarot, with the Tree of Life and astrology cross-linked. Live at toth.jakub.computer

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages