Arkano

Arkano is a modern, AI-powered platform for Tarot and Esotericism. It acts as an interactive tool that provides users with deep, personalized tarot readings generated by artificial intelligence.

Key Features:

AI-Powered Readings: Uses Google Gemini to generate custom interpretations of tarot card spreads. Esoteric RAG (Retrieval-Augmented Generation): The AI's interpretations are grounded in actual esoteric PDF manuals that have been parsed and loaded into a vector database, ensuring high-quality, specialized responses. Credit & Wallet System: Users have a digital wallet to manage credits. They get daily free readings and can purchase more credits through integrations like Stripe or "Pago Móvil". Multilingual Support: Fully supports English and Spanish. Admin Dashboard: Includes an administration panel to manage users, assign funds, review support tickets, and configure global settings. Native Automations: Uses background database cron jobs (pg_cron) to handle daily resets, like giving out daily free credits. 🛠️ Technology Stack The project is built on a modern, full-stack JavaScript/TypeScript ecosystem.

Core & Frontend:

Framework: Next.js 16.1 (using App Router) Language: TypeScript and React 19 Styling: Tailwind CSS v4 Icons: Lucide React Internationalization (i18n): next-intl Markdown Rendering: react-markdown and remark-gfm (likely used to render the AI's rich-text responses cleanly) Backend & Infrastructure:

Database, Auth & Storage: Supabase Uses Supabase Auth for session handling and role-based access control (Admin vs. User). Uses PostgreSQL (with pgvector for RAG capabilities) and pg_cron for database-level task scheduling. AI Integration: Google Gemini (@google/genai) Payments & Emails:

Payments: Stripe integration Transactional Emails: Resend Analytics & Monitoring:

Analytics: PostHog (posthog-js, posthog-node) and Vercel Analytics (@vercel/analytics) Utilities / Scripts:

PDF Processing: pdf-parse (used in backend scripts to ingest the esoteric manuals for the RAG architecture)