Inspiration
Traditional Vedic astrology consultation is often expensive, time-consuming, and geographically limited. We wanted to make this guidance accessible, affordable, and available 24/7. Combining ancient Vedic principles with modern AI can provide personalized insights while preserving cultural authenticity. JyotishMitra bridges traditional wisdom and contemporary technology to serve users seeking astrological guidance.
What it does
JyotishMitra is a Progressive Web App that provides AI-powered Vedic astrology consultation. It generates birth charts (Kundli) with planetary positions, houses, and Nakshatras. Users can chat with an AI assistant for personalized guidance on career, relationships, and life decisions. The app includes Kundli matching for compatibility analysis, Muhurta finder for auspicious timing, and personalized Vedic remedies. All features work offline, and the app can be installed on mobile and desktop devices.
How we built it
We built JyotishMitra using React 18 with TypeScript for the frontend, Vite for build tooling, and Tailwind CSS for styling. The AI chat interface integrates Google Gemini 2.5 Flash for conversational responses. We use VedAstro API for authentic Vedic astrological calculations and Free Astrology API for Kundli matching and Muhurta. The PWA functionality is implemented with service workers for offline support and a web app manifest for installation. Framer Motion handles animations, and React Router manages navigation. The app follows a component-based architecture with clear separation between UI, services, and data layers.
Challenges we ran into
Integrating multiple APIs with different response formats required careful data transformation. Ensuring ethical AI responses that avoid fearmongering while maintaining astrological authenticity required custom prompt engineering and safety filters. Implementing PWA features like service workers and offline caching had browser compatibility considerations. Mobile responsiveness, especially for the chat interface and bottom navigation, required multiple iterations. Handling complex astrological calculations and presenting them in an understandable format was challenging. Managing API rate limits and implementing proper error handling for network failures required robust fallback mechanisms.
Accomplishments that we're proud of
We successfully created a fully functional PWA that works offline and can be installed on any device. The AI chat provides context-aware responses based on the user's birth chart data. We implemented comprehensive error handling with user-friendly messages and retry mechanisms. The app is WCAG 2.1 AA compliant with proper accessibility features. We built ethical AI guardrails to prevent harmful predictions. The mobile-first design provides a native app experience. We achieved fast load times through service worker caching and code optimization. The PDF export feature allows users to save their birth charts offline.
What we learned
We learned how to effectively integrate multiple APIs and handle different data structures. Building a PWA requires understanding service workers, caching strategies, and manifest configuration. Prompt engineering for AI requires careful crafting to balance accuracy, ethics, and user experience. Mobile-first design demands attention to touch targets, safe areas, and responsive layouts. TypeScript's type system helps catch errors early and improves code maintainability. Accessibility is not optional; proper ARIA labels and keyboard navigation are essential. Error handling and loading states significantly improve user experience. Vedic astrology has complex calculations that require careful API integration and data presentation.
What's next for JyotishMitra
We plan to add push notifications for daily horoscope updates and important astrological events. Multi-language support for Hindi, Marathi, and Gujarati is in development. Dark mode theme will be implemented based on user preferences. Background sync will allow offline form submissions to sync when connectivity is restored. Advanced transit predictions and yearly horoscope generation are planned. We will add a remedial measure tracking system to help users follow suggested remedies. Community features for sharing experiences and learning from others are under consideration. Voice input for the chat interface will improve accessibility. We will implement analytics to understand user needs and improve the AI responses. Integration with calendar apps for muhurta recommendations is planned.
Log in or sign up for Devpost to join the conversation.