🔮 魔法塔罗牌 - 每日占卜 | Magic Tarot

🔮 Magic Tarot - Daily Divination

A comprehensive tarot divination Chrome extension bringing the wisdom of 8 tarot decks and 40+ spread layouts right to your browser. Whether you seek daily guidance, relationship insights, career advice, or spiritual growth, Magic Tarot offers a complete toolkit for self-reflection and divination.

✨ Features

8 Premium Decks: Magic, Rider-Waite, Marseille, Thoth, Angel, Healing, Osho Zen (79 cards), and Stellar Tarot — each with unique artwork and interpretations
40+ Spread Layouts: From simple single-card draws to the full Celtic Cross, organized into 9 categories for every life situation
Daily Fortune: Auto-generated daily tarot reading with a fresh card each day
Lucky Number Generator: Generate random lucky numbers with tarot-based interpretations
Dilemma Helper: Three decision-making tools — rock-paper-scissors, dice rolling, and tarot card draw
Bilingual Interface: Full Chinese and English localization, switchable anytime
Reading History: Review your past tarot readings, filtered by date
Card Collection: Save and organize your favorite cards with personal notes
Reading Modes: Choose from Simple, Standard, or Deep interpretation levels
Extended Analysis: Additional insights including historical analysis, timing dimensions, and personality analysis
AI Deep Reading: Powered by your own AI provider, generates a structured, in-depth reading (overall energy, per-card analysis, insights, actionable steps, and a one-line summary) with elegant typography and serif headings
AI Follow-up Q&A: Ask follow-up questions in a multi-turn conversation; the full reading and follow-up thread persist after closing and reopening the popup
Custom Card Meanings: Edit and personalize your card interpretations
Sound Effects: Optional card-flipping sound effects (toggle on/off)
Card Preview: Click to view full card details, meanings, and symbolism
Share Results: Copy and share your reading results with friends
Dark Magic Theme: Beautiful dark-themed UI with responsive design

🎴 Supported Decks

Deck	Cards	Style	Description
Magic 🪄	78	Fantasy Magic	Magical themed tarot cards with enchanting artwork
Rider-Waite 📖	78	Classic	The most widely used tarot deck worldwide
Marseille 🏛️	78	Traditional	Historic Marseille tarot with medieval symbolism
Thoth ⚡	78	Esoteric	Aleister Crowley's Thoth tarot with astrological associations
Angel 👼	78	Spiritual	Angel-themed cards with gentle, uplifting guidance
Healing 💚	78	Therapeutic	Healing-focused cards for emotional wellness
Osho Zen 🧘	79	Enlightenment	Based on Osho's Zen wisdom — focuses on the present moment (the only deck with 79 cards)
Stellar 🌟	78	Cosmic	Starry universe theme with astrological constellations

📋 Supported Spreads (40+)

Beginner & Classic

Spread	Cards	Purpose
Single Card	1	Quick daily guidance
Three Card Spread	3	Past, Present, Future
Problem-Action-Result	3	Situation analysis
Yes/No Spread	1	Simple binary answers

Relationships & Emotions

Spread	Cards	Purpose
Relationship Spread	5	Love and relationship insights
Lovers Spread	7	Deep relationship analysis
Reconciliation Spread	5	Guidance for getting back together
Family Relations	5	Family dynamics understanding
Friendship Spread	3	Friendship guidance
Emotional Patterns	6	Explore emotional patterns

Decisions & Analysis

Spread	Cards	Purpose
Two Options	2+2	Binary choice analysis
Pros & Cons	6	Weighing advantages and disadvantages
Crossroads	5	Multi-path decision guidance
Stay or Leave	6	Major life decisions
Decision Tree	7	Hierarchical decision analysis
Five Card Spread	5	General decision making

Life & Daily

Spread	Cards	Purpose
Travel Spread	4	Travel guidance
Finance & Investment	5	Financial decisions
Lost & Found	4	Guidance for finding lost items
Health Spread	5	Health and wellness insights
New Skill Learning	4	Learning path guidance
Daily Habit Optimization	3	Habit improvement

Fortune & Prediction

Spread	Cards	Purpose
Monthly Fortune	4+	Month-ahead forecast
Flow of Time	4	Temporal progression reading
Wheel of Fortune	5	Destiny and timing
Yearly Forecast	12	Full year prediction
Weekly Fortune	7	Week-ahead guidance
Four Seasons	4	Seasonal energy reading

Advanced & Deep

Spread	Cards	Purpose
Celtic Cross	10	Comprehensive life reading (the classic)
Horseshoe Spread	7	Detailed situation analysis
Zodiac Spread	12	All 12 houses astrological influence
Annual Prediction	12	12-month detailed forecast
Forgiveness Spread	6	Healing and forgiveness
Tree of Life	10	Kabbalistic life wisdom

Career & Education

Spread	Cards	Purpose
Career Spread	5	Career direction guidance
Job Change	6	Guidance for changing jobs
Exam Spread	4	Academic exam preparation
Office Relations	4	Workplace relationship insights
Side Hustle	5	Side business exploration
Startup Feasibility	7	Entrepreneurship guidance

Self & Personal Growth

Spread	Cards	Purpose
Soul Spread	5	Inner soul exploration
Decluttering	4	Letting go and simplifying
Shadow Work	6	Confronting the shadow self
Self-Worth	5	Building self-esteem
Inner Child Healing	6	Childhood wound healing
Dream Interpretation	4	Dream analysis guidance

Spiritual Growth

Spread	Cards	Purpose
Life Purpose	8	Find your life mission
Soul Journey	9	Spiritual path exploration
Past Lives	5	Karmic past life insights
Creative Inspiration	4	Unlock creative potential
Higher Self Connection	5	Connect with higher consciousness
Chakra Balance	7	7 chakra energy alignment

🎲 Extra Tools

Tool	Description
Daily Fortune 🌅	Auto-generated daily card with personalized interpretation
Lucky Number Generator 🔢	Generate random numbers within a custom range, with tarot interpretation
Dilemma Helper 🤔	Three ways to help with decisions: rock-paper-scissors, dice rolling, or tarot card draw

📦 Installation

From Chrome Web Store (Recommended)

Manual Installation (Developer Mode)

Clone the repository

git clone https://github.com/vaxicy/tarot-chrome-extension.git

Open Chrome and navigate to chrome://extensions/
Enable "Developer mode" (top right corner)
Click "Load unpacked" and select the cloned folder
The extension icon will appear in your Chrome toolbar

🚀 Quick Start

Click the Magic Tarot icon in your Chrome toolbar
Select your preferred tarot deck from the 8 available options
Choose your language (Chinese/English)
Pick a spread layout from the categorized list
Click "Draw Cards" to shuffle and reveal
Click on individual cards to reveal their meanings and interpretations
Save your favorites, review history, or share results

🛠️ Technical Details

Aspect	Detail
Manifest	Version 3 (MV3)
Permissions	`storage` only (local history, favorites, settings)
Architecture	Pure vanilla JavaScript, HTML5, CSS3
Dependencies	Zero external libraries or frameworks
Storage	`chrome.storage.local` API
Image Assets	Node.js scripts (sharp + SVG) for card back/deck generation

📁 Project Structure

tarot-chrome-extension/
├── manifest.json              # Extension config (MV3)
├── _locales/                  # Chrome Web Store i18n (en + zh_CN)
├── popup.html                 # Main UI (1083 lines)
├── popup.css                  # Stylesheet (135KB)
├── popup.js                   # Core logic (445KB)
├── constants.js               # Constants, i18n, card meanings (231KB)
├── config.js                  # Feature toggles
├── deck-manager.js            # Deck management (DeckManager class)
├── dilemma-spread.js          # Dilemma helper module
│
├── base-cards.js              # Base card data structures
├── tarot-cards.js             # Magic deck
├── rider-waite-cards.js       # Rider-Waite deck
├── marseille-cards.js         # Marseille deck
├── thoth-cards.js             # Thoth deck
├── angel-cards.js             # Angel deck
├── healing-cards.js           # Healing deck
├── osho-zen-cards.js          # Osho Zen deck (79 cards)
├── stellar-cards.js           # Stellar Tarot deck
│
├── icons/                     # Extension icons
│   ├── icon16.png             # 16px icon
│   ├── icon48.png             # 48px icon
│   ├── icon128.png            # 128px icon
│   ├── card-backs/            # 9 deck back images
│   ├── major/                 # Major Arcana (22)
│   ├── wands/                 # Wands (14)
│   ├── cups/                  # Cups (14)
│   ├── swords/                # Swords (14)
│   ├── pentacles/             # Pentacles (14)
│   ├── osho/                  # Osho Zen (79 placeholders)
│   └── stellar/               # Stellar Tarot (78 placeholders)
│
├── payment.html               # Payment/checkout page
├── PRIVACY_POLICY.md          # Privacy policy (bilingual)
├── package.json               # npm config
├── package-extension.js       # Build & package script (archiver)
│
├── gen_card_backs.js          # Card back generation script
├── gen_osho.js                # Osho Zen data generator
├── gen_osho_images.js         # Osho Zen placeholder images
├── gen_stellar_images.js      # Stellar Tarot card images
├── build_osho.js              # Osho Zen data builder
├── add_keywords.js            # Add keywords to Marseille deck
└── analyze_keywords.js        # Keyword coverage analysis

🏗️ Building & Packaging

# Install dependencies
npm install

# Package extension
npm run package
# or manually:
node package-extension.js

🔒 Privacy

Magic Tarot respects your privacy:

No data collection: No personal information is collected or transmitted
Local storage only: All history, favorites, and settings stay on your device
Single permission: Only storage is required

See PRIVACY_POLICY.md for full details.

🤝 Contributing

Contributions are welcome! Please follow these steps:

Fork the repository
Create your feature branch (git checkout -b feature/AmazingFeature)
Commit your changes (git commit -m 'Add some AmazingFeature')
Push to the branch (git push origin feature/AmazingFeature)
Open a Pull Request

Please ensure your code follows the existing style (vanilla JS, no framework dependencies).

📝 License

This project is licensed under the Non-Commercial License — see the LICENSE file for details.

For commercial use, please contact the author.

📬 Contact & Support

GitHub Issues: Report a bug or suggest a feature
Author: vaxicy (huangzero2004@gmail.com)
Chrome Web Store: Magic Tarot on Chrome Web Store