Vedic Astrology Build

Introduction

The Vedic Astrology Build project aims to create a web application that generates a free Vedic Kundali and provides an AI-driven personality analysis. The application will feature a minimalist user interface and leverage free APIs for astrology calculations and AI analysis. The tech stack will include React or Next.js for the frontend, Tailwind CSS for styling, and Node.js or Python for the backend.

System Overview

The Vedic Astrology Build application will allow users to input personal details to generate a Vedic Kundali chart and receive a personalized AI analysis. The system will integrate astrology and AI APIs to deliver accurate and insightful results.

Functional Requirements as Story Points

• As a User, I should be able to access a clean, minimalist home page with a form to input my Name, Date of Birth, Time of Birth, and Place of Birth.
• As a User, I should be able to use an autocomplete city picker to select my city, which captures Latitude, Longitude, and Timezone using a free geocoding API.
• As a User, I should be able to view a results dashboard displaying a visual 12-house South Indian or North Indian style Kundali chart grid.
• As a System, I should integrate a free astrology calculation library or API to compute the Ascendant (Lagna) and positions of the 9 traditional planets based on user inputs.
• As a System, I should format the astrology output into a JSON structure mapping planets to their respective houses.
• As a System, I should connect to a free AI API to generate a 300-word analysis detailing the user's core personality traits, strengths, and career inclinations based on the Vedic astrology data.

User Personas

• General User: Individuals interested in understanding their Vedic astrology chart and receiving personalized personality insights.

Core User Flows

1. User visits the home page -> Inputs Name, Date of Birth, Time of Birth, and Place of Birth -> Uses autocomplete city picker -> Submits form -> System calculates Kundali -> Displays Kundali chart and AI analysis on results dashboard.

Visuals Colors and Theme

• primary: #4A90E2 (a calming blue for trust and reliability)
• primary_light: #A6C8FF (a lighter blue for hover states)
• secondary: #FF6F61 (a warm coral for emphasis and links)
• accent: #FFD700 (a vibrant gold for CTAs and active states)
• highlight: #FFA500 (a bright orange for notifications and hover states)
• bg: #FFFFFF (a clean white background)
• surface: rgba(255, 255, 255, 0.9) (a subtle white for cards/panels)
• text: #333333 (a dark gray for primary text)
• text_muted: #777777 (a softer gray for secondary text)
• border: rgba(0, 0, 0, 0.1) (a light gray for borders)

Signature Design Concept

The homepage will feature an interactive celestial map that users can explore. As users input their birth details, constellations and planets will dynamically align to form their personalized Kundali chart. This celestial map will be interactive, allowing users to hover over planets and houses to see brief descriptions and insights. The map will be created using motion/react for smooth animations and transitions, providing an engaging and educational experience.

Landing Hero Motion Brief

The landing hero will depict a celestial scene where stars and planets gradually align to form the user's Kundali chart. As the user inputs their details, the celestial bodies will animate into position, revealing the chart's structure. The animation will loop every 10 seconds, showing the transformation from a starry sky to a detailed Kundali chart. Users can interact by hovering over elements to learn more about their astrological significance.

Interaction Model & Motion Direction

• Intended Interaction Model: Animated
  • The landing page will feature moderate scroll-triggered reveals and hover transitions, with spring physics on interactive elements to enhance user engagement.
• Internal Pages: Static
  • Focus on layout clarity with minimal motion for the results dashboard and other internal pages.

Non-Functional Requirements

• The application must be responsive and accessible across various devices and screen sizes.
• The system should ensure data privacy and secure handling of user inputs.

Tech Stack

• Frontend: React or Next.js
• Styling: Tailwind CSS
• Backend: Node.js or Python
• APIs: Free astrology calculation library or API, Free AI API for personality analysis

Assumptions and Constraints

• The application will use only free APIs and libraries to maintain zero cost.
• The system will require internet connectivity to access external APIs for astrology calculations and AI analysis.

Glossary

• Kundali: A Vedic astrology chart representing the positions of planets at the time of an individual's birth.
• Ascendant (Lagna): The zodiac sign rising on the eastern horizon at the time of birth, crucial in Vedic astrology.
• AI Analysis: An automated interpretation of astrological data to provide insights into personality traits and career inclinations.