How rahul300rkv/arcana-ai works
AstroFree is a multilingual tarot-reading and Vedic-numerology web app. Users enter through routed pages, choose a reading or calculator, and receive card interpretations or number-based results; tarot and numerology AI endpoints are documented with deterministic fallback. Guides, card meanings, daily-card content, and personal reading areas extend the core tools. The graph separates experience, domain logic, and server integrations. Some screens and AI service code were not sampled, so their links are shown only where documented or marked unverified.
Main entry points: screens Tarot Screens · server.ts API Server · index.tsx Landing Page · i18n.ts Translations
Components 26
Web Experience
- Route Registry
src/routeTree.gen.ts - App Router
src/App.tsx - Landing Page
src/routes/index.tsx
Tarot Readings
- Tarot Screens
src/screens - Card Meanings
src/screens/TarotCardScreen.tsx - Deck and Draw
src/lib/tarot/engine.ts - Spread Definitions
src/lib/tarot/spreads.ts - Interpretations
src/lib/tarot/interpret.ts - Reading History
src/lib/tarot/history.ts - Card Content
src/data/tarot-cards
Numerology
- Numerology Screens
src/screens - Number Engine
src/lib/numerology/engine.ts - Number Meanings
src/lib/numerology/interpret.ts - Numerology Content
src/data
Guides and Content
- Guides and Articles
src/screens/guides - Daily Card
src/components/app/DailyCard.tsx - Article Ads
src/components/ads/InArticleAd.tsx
Server and Shared
- API Server
server.ts - Numerology AI
src/lib/numerology/ai.server.ts - Tarot AI
src/lib/tarot/ai.server.ts - Translations
src/lib/i18n.ts - Language State
src/lib/language.ts - Site Metadata
src/lib/site.ts - Ad Configuration
src/lib/adsense.ts
Other components
- Visitor
- Google Gemini
Connections 26
- Visitor → App Router: opens app
- App Router → Route Registry: loads routes
src/App.tsx - Visitor → Landing Page: visits
- Landing Page → Tarot Screens: links to
- Landing Page → Numerology Screens: links to
src/routes/index.tsx - Tarot Screens → Deck and Draw: draws cards
- Tarot Screens → Spread Definitions: uses spreads
- Tarot Screens → Interpretations: shows meanings
- Card Meanings → Card Content: shows meanings
- Tarot Screens → Reading History: stores readings
- API Server → Spread Definitions: looks up spread
server.ts - API Server → Deck and Draw: looks up cards
server.ts - API Server → Google Gemini: requests generation
server.ts - Numerology Screens → Number Engine: calculates numbers
src/screens/NumerologyIndexScreen.tsx - Numerology Screens → Numerology AI: requests reading
src/screens/NumerologyIndexScreen.tsx - Numerology Screens → Numerology Content: uses reference data
- API Server → Number Engine: calculates numbers
server.ts - Numerology AI → API Server: calls API
- Tarot AI → API Server: calls API
- Guides and Articles → Article Ads: renders ad
src/screens/guides/GuideNumerologyScreen.tsx - Daily Card → Card Content: uses card content
- Tarot Screens → Translations: localizes interface
src/screens/NumerologyIndexScreen.tsx - Numerology Screens → Translations: localizes interface
src/screens/NumerologyIndexScreen.tsx - Translations → Language State: reads language
src/lib/i18n.ts - Guides and Articles → Site Metadata: uses site metadata
- Article Ads → Ad Configuration: uses ad settings
src/components/ads/InArticleAd.tsx