🌸 Vedic Astrology Guide (Phase 2: Interpretive Grounding)

A high-fidelity astrological data capture and AI-driven interpretation engine. This project uses the "4-Doc Rule" for infinite context memory: CHANGELOG.md, PROJECT_STATUS.md, APP_CONTEXT.md, and README.md.

✨ Features

• Phase 1 Automated Sync: Command-line sync-user tool to populate charts and tables from JHora Markdown exports.
• Table-First Architecture: Seamlessly handles Markdown tables and ASCII grids for 100% technical fidelity.
• Premium UI/UX: High-fidelity "Stone" palette with scorable pickers, tooltips, and space-efficient dropdowns.
• Varga & Transit Synthesis: Rapid multi-chart selection and streamlined transit data capture.
• AI-Native Design: Optimized for Gemini 1.5/2.5 Flash models with task-splitting logic to save context tokens.

🚀 Getting Started

Prerequisites

• Node.js (v18+)
• Google Gemini API Key
• Supabase Project (for profile synchronization)

Installation

1. Install dependencies: bash npm install
2. Configure Environment: Create a .env file and add your keys: env VITE_GEMINI_API_KEY=your_key VITE_SUPABASE_URL=your_url VITE_SUPABASE_ANON_KEY=your_key
3. Sync a Profile: bash npm run sync-user -- "path/to/jhora-export.md"
4. Launch App: bash npm run dev

🛠️ Tech Stack

• Framework: React + Vite
• Database: Supabase (PostgreSQL)
• Styling: Vanilla CSS + Tailwind CSS
• AI: Google Generative AI (Gemini 1.5/2.5 Flash)

📁 Repository Structure

• repository/guides/: The Vedic Master Manual and interpretive workflows.
• repository/datasets/: User birth data, dummy data, and JHora logs.
• repository/archive/: Deprecated documentation and legacy guides.
• src/services/: Core logic (Parser, Dasha Formatter, Gemini Integration).
• src/components/: Modular UI (Gochara, SAV, Varga Selection).
• tests/: Experimental and verification scripts.
• docs/: Active alignment (Features, UI Flow, Brain Guide).