How vedaai25/astro_assist works
Astro_assist is a Vedic astrology application with a React frontend and a Node backend. The main user journey is entering birth details and location, requesting a natal chart, then exploring chart views and personalized readings, dasha phases, and transits. The tree also shows dedicated features for daily alerts, long-range forecasts, karma, consultations, and self-analysis. Frontend excerpts establish chart-query and rendering relationships; the README gives no architectural detail, and most backend routes and calculations were not sampled, so their connections are left unspecified.
Main entry points: App.jsx Chart Experience · useChartQuery.js Chart Query · OnboardingWizard.jsx Birth Onboarding · SouthIndianChart.jsx Chart Views
Components 22
User Experience
- Chart Experience
frontend/src/App.jsx - Birth Onboarding
frontend/src/components/OnboardingWizard/OnboardingWizard.jsx - Chart Views
frontend/src/components/Chart/SouthIndianChart.jsx - Reading Pages
frontend/src/components/ReadingPage.jsx - Transit Views
frontend/src/components/TransitPage.jsx - Current Time
frontend/src/components/CurrentTimePage.jsx
Frontend Data
- Onboarding State
frontend/src/features/onboarding/onboardingSlice.js - Location State
frontend/src/features/location/locationSlice.js - Chart Query
frontend/src/hooks/useChartQuery.js - Chart API Client
frontend/src/features/chart/chartApi.js - Reading State
frontend/src/features/readings/readingsSlice.js - Transit API Client
frontend/src/features/transit/transitApi.js
Astrology Domain
- Vedic Calculations
frontend/src/utils/vedic-utils.js - Daily Alert Engine
frontend/src/utils/dailyAlerts/horaEngine.js - Consultation Engine
frontend/src/utils/consultation/questionEngine.js - Chart Context
backend/src/astro/context.js - Chart Calculator
backend/src/astro/chartCalculator.js
Backend Services
- API Routes
backend/src/routes/chart.js - Reading Routes
backend/src/routes/readings/index.js - Profile Store
backend/src/db/profileStore.js - Gemini Service
backend/src/utils/gemini.js
Other components
- Astrology User
Connections 5
- Astrology User → Birth Onboarding: enters birth details
- Astrology User → Chart Experience: explores astrology
- Chart Experience → Chart Query: requests chart
frontend/src/App.jsx - Chart Query → Chart API Client: calls
frontend/src/hooks/useChartQuery.js - Chart Experience → Chart Views: renders
frontend/src/App.jsx