Package Exports
- tarotap
- tarotap/dist/index.js
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (tarotap) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
Tarotap - Tarot Card Library
Complete 78-card Tarot deck library
Features
- Complete 78 tarot cards (22 Major Arcana + 56 Minor Arcana)
- Multi-language support (English, German, Spanish, French, Italian, Japanese, Korean, Dutch, Portuguese, Russian, Traditional Chinese, Simplified Chinese)
- Random card drawing
- Search cards by name or ID
- Filter by Major/Minor Arcana and suits
- Zero dependencies
Installation
npm install tarotap
Usage
import { getRandomCard, drawCards, getCardById, getMajorArcana, TarotCard } from 'tarotap';
// Get a random card (English by default)
const card: TarotCard = getRandomCard();
console.log(card.name); // "The Fool"
// Get a random card in German
const cardDE: TarotCard = getRandomCard('de');
console.log(cardDE.name); // "Der Narr"
// Get a random card in Spanish
const cardES: TarotCard = getRandomCard('es');
console.log(cardES.name); // "El Loco"
// Get a random card in French
const cardFR: TarotCard = getRandomCard('fr');
console.log(cardFR.name); // "Le Mat"
// Get a random card in Italian
const cardIT: TarotCard = getRandomCard('it');
console.log(cardIT.name); // "Il Matto"
// Get a random card in Japanese
const cardJA: TarotCard = getRandomCard('ja');
console.log(cardJA.name); // "愚者"
// Get a random card in Korean
const cardKO: TarotCard = getRandomCard('ko');
console.log(cardKO.name); // "바보"
// Get a random card in Dutch
const cardNL: TarotCard = getRandomCard('nl');
console.log(cardNL.name); // "De Dwaas"
// Get a random card in Portuguese
const cardPT: TarotCard = getRandomCard('pt');
console.log(cardPT.name); // "O Louco"
// Get a random card in Russian
const cardRU: TarotCard = getRandomCard('ru');
console.log(cardRU.name); // "Шут"
// Get a random card in Traditional Chinese
const cardTW: TarotCard = getRandomCard('tw');
console.log(cardTW.name); // "愚者"
// Get a random card in Simplified Chinese
const cardZH: TarotCard = getRandomCard('zh');
console.log(cardZH.name); // "愚人"
// Draw multiple cards
const cards: TarotCard[] = drawCards(3, false, 'ja');
// Get specific card
const fool: TarotCard | null = getCardById('the-fool', 'en');
// Get Major Arcana in Korean
const majorArcana: TarotCard[] = getMajorArcana('ko');
CommonJS:
const tarotap = require('tarotap');
const card = tarotap.getRandomCard('de');
API
getAllCards(language?)
- Get all 78 cardsgetCardById(id, language?)
- Get card by IDgetRandomCard(language?)
- Get random carddrawCards(count, allowDuplicates?, language?)
- Draw multiple cardsgetMajorArcana(language?)
- Get Major Arcana cardsgetMinorArcana(language?)
- Get Minor Arcana cardsgetCardsBySuit(suit, language?)
- Get cards by suitsearchCards(query, language?)
- Search cards
Languages: 'en'
(English), 'de'
(German), 'es'
(Spanish), 'fr'
(French), 'it'
(Italian), 'ja'
(Japanese), 'ko'
(Korean), 'nl'
(Dutch), 'pt'
(Portuguese), 'ru'
(Russian), 'tw'
(Traditional Chinese), 'zh'
(Simplified Chinese)
Card Format
{
"id": "the-fool",
"name": "The Fool"
}
Live Demo
Try it at Tarotap.com
License
MIT
Made with ❤️ by the Tarotap Team - Bringing ancient wisdom to the digital age