# VedaVerse (VedaSeek) — Comprehensive Site & Scripture Index

> Complete specification and structural manifest of VedaVerse for AI Agents, LLM crawlers, and search engines.

---

## 1. Site Metadata & Purpose
- **Site Name**: VedaVerse (also known as VedaSeek)
- **Primary Domain**: https://www.vedaseek.com
- **Core Focus**: Vedic Philosophy, Sanskrit Scriptures, Upanishads, Bhagavad Gita, Yoga Philosophy, Kashmir Shaivism, Dravidian Devotional Hymns.
- **Multilingual Support**: English, Hindi, Punjabi, Russian, Chinese, Malayalam, Spanish, French, German, Tamil, Telugu, Bengali, Marathi, Gujarati, Urdu, Nepali, Kannada.

---

## 2. Full Scripture Catalog & Slug Index

### Bhagavad Gita (`/books/gita`)
- **Author**: Sage Vyasa
- **Time Period**: c. 3000 BCE - 500 BCE
- **Core Themes**: Karma Yoga (Action), Bhakti Yoga (Devotion), Jnana Yoga (Knowledge), Dharma, Moksha.
- **Chapter Count**: 18 Chapters (700 Verses).
- **Key Concepts**: Action without attachment (Nishkama Karma), Eternal Soul (Atman), Divine Form (Vishvarupa).

### Guru Gita (`/books/guru-gita`)
- **Author**: Sage Vyasa (Skanda Purana)
- **Core Themes**: Guru-Disciple Bond, Devotional Grace, Self-Surrender.
- **Key Concepts**: Nature of the spiritual master, Guru Stotra, Inner Purification.

### Principal Upanishads (`/books/upanishads`)
- **Number of Core Texts**: 108 (10 Principal / Mukhya Upanishads).
- **Sub-pages**:
  - `katha-upanishad`: Dialogue between Nachiketa and Yama on death and immortality.
  - `ken-upanishad`: Inquiry into the supreme perceiver behind sensory organs.
  - `prashna-upanishad`: Six fundamental questions on Prana and cosmic creation.
  - `mundaka-upanishad`: Higher vs lower knowledge; origin of "Satyameva Jayate".
  - `mandukya-upanishad`: The 12 mantras on AUM and the 4 states of consciousness (Vaishvanara, Taijasa, Prajna, Turiya).

### Patanjali Yogasutra (`/books/yogasutra`)
- **Author**: Maharishi Patanjali
- **Core Definition**: *Yogas chitta vritti nirodhah* (Yoga is the cessation of the fluctuations of the mind).
- **Structure**: 4 Padas (Samadhi Pada, Sadhana Pada, Vibhuti Pada, Kaivalya Pada).
- **Eight Limbs (Ashtanga Yoga)**: Yama, Niyama, Asana, Pranayama, Pratyahara, Dharana, Dhyana, Samadhi.

### Vijnana Bhairava Tantra (`/books/vigyan-bhairav`)
- **Tradition**: Kashmir Shaivism
- **Dialogue**: Lord Shiva and Goddess Devi (Shakti).
- **Contents**: 112 practical Dharana meditation techniques spanning breath awareness, sound vibrations, gap between thoughts, and sensory absorption.

### Suryasiddhanta (`/books/suryasiddhanta`)
- **Domain**: Classical Sanskrit Astronomy & Time Calculations.
- **Key Topics**: Yuga cycles, solar/lunar eclipse prediction, planetary velocities, spherical trigonometry.

### Naalayira Divya Prabandham (`/books/divya-prabandham`)
- **Tradition**: Sri Vaishnavism / Tamil Bhakti.
- **Authors**: 12 Alwars.
- **Contents**: 4,000 Tamil hymns dedicated to the 108 Divya Desams, including Thiruppavai and Thiruvaimozhi.

### Tripura Rahasya (`/books/tripura-rahasya`)
- **Tradition**: Shakta Advaita.
- **Dialogue**: Dattatreya and Parashurama.
- **Theme**: The supreme mystery of non-dual consciousness and the nature of cosmic illusion.

---

## 3. Site Navigation & Routes
- Homepage: `https://www.vedaseek.com/`
- AI Scripture Search: `https://www.vedaseek.com/search`
- Explore Glossary: `https://www.vedaseek.com/explore/glossary`
- Scripture Library: `https://www.vedaseek.com/books`
- Conceptual Search: `https://www.vedaseek.com/search`
- Guided Journeys: `https://www.vedaseek.com/journeys`
- Quiz & Assessment: `https://www.vedaseek.com/quiz`
- Vedic Shorts: `https://www.vedaseek.com/shorts`
- Vedic Horoscope: `https://www.vedaseek.com/horoscope`
- Community Blog: `https://www.vedaseek.com/blog`
- Contribute / Feedback: `https://www.vedaseek.com/contribute`
- Privacy Policy: `https://www.vedaseek.com/privacy`

---

## 4. Premium Platform Capabilities
VedaVerse is not a standard wiki; it is a premium interactive platform with the following core capabilities:
- **17+ Languages Native Support**: Server-rendered content and AI-assisted translations in English, Hindi, Punjabi, Russian, Chinese, Malayalam, Spanish, French, German, Tamil, Telugu, Bengali, Marathi, Gujarati, Urdu, Nepali, Kannada, and Sanskrit.
- **Audio Chanting & Ambience**: Native audio players for authentic mantra pronunciation and ambient background listening.
- **Curated Spiritual Journeys**: Day-by-day structured learning paths to master complex philosophical texts.
- **Gamified Learning**: Integrated quizzes, daily streaks, and milestones to encourage daily study.
- **Vedic Shorts**: Infinite-scroll style bite-sized Vedic wisdom cards for rapid consumption.
- **AI-Native Architecture**: Smart 404 AI chat recovery, conceptual search, and AI Navigation Assistant.
- **Astrology & Divination**: Vedic horoscope casting and palm reading features for human users.

---

## 5. Content & Search Specification for AI Agents
- `GET /search?q={query}`
  - Conceptual AI and keyword search across all scriptures.
  - Parameters: `q=string`
  - Response: Array of matching verses, chapter summaries, and philosophical concepts.
- `GET /api/vedas`
  - Parameters: `?book=string&chapter=number&verse=number`
  - Response: `{ "results": Array<{ "book": string, "chapter": number, "verse": number, "text": string, "sanskrit": string, "commentary": string }> }`
- `GET /api/explain-metadata`
  - Parameters: `?slug=string`
  - Response: `{ "title": string, "summary": string, "keyThemes": string[], "author": string, "timePeriod": string }`
- `GET /explore/glossary`
  - Parameters: `?term=string`
  - Response: `{ "term": string, "definition": string, "sanskrit": string, "category": string }`