README

Structured meanings and helpers for all 22 Major Arcana cards, built by Deckaura.

Includes upright, reversed, love, career, yes/no, keywords, and elemental associations. The companion open dataset covers the complete 78-card deck.

Installation

composer require deckaura/tarot-card-meanings

Usage

<?php

require_once 'vendor/autoload.php';

use Deckaura\Tarot\TarotCardMeanings;

// Get all Major Arcana cards
$cards = TarotCardMeanings::getMajorArcana();
echo $cards[0]['name'];        // "The Fool"
echo $cards[0]['upright'];     // "New beginnings, innocence, spontaneity, free spirit"
echo $cards[0]['element'];     // "Air"

// Draw a random card
$card = TarotCardMeanings::randomCard();
echo "{$card['name']}: {$card['upright']}";

// Get today's daily card (same card for same date)
$daily = TarotCardMeanings::dailyCard();
echo "Today's card: {$daily['name']}";
echo "Love: {$daily['love']}";
echo "Career: {$daily['career']}";
echo "Yes/No: {$daily['yes_no']}";

// Access card keywords
$keywords = implode(', ', $cards[1]['keywords']);
echo $keywords;  // "manifestation, willpower, creation, skill"

Card Properties

Each card is an associative array with:

Key	Description
`name`	Card name (e.g., "The Fool")
`upright`	Upright meaning
`reversed`	Reversed meaning
`love`	Love and relationship interpretation
`career`	Career and work interpretation
`yes_no`	Yes, No, or Maybe answer
`keywords`	Array of associated keywords
`element`	Associated element (Air, Water, Fire, Earth)

Free Tarot Tools by Deckaura

Related Packages

NPM: tarot-card-meanings
PyPI: tarot-card-meanings
Go: github.com/gokimedia/tarot-card-meanings-go
Rust: tarot-card-meanings

Open Data & Developer Resources

Blog Post

Read How I Shipped a Tarot Card API to Every Major Package Registry in One Day for the full story behind this project.

deckaura / tarot-card-meanings

Maintainers

Package info

Statistics

Security