How kashvi009/janani-ai-compass works
Project type and purpose
• This is a full-stack, AI-powered maternal health web application (JANANI).
• Frontend: React + TypeScript + Vite + Tailwind CSS + shadcn/ui.
• Backend: Supabase (Auth, Postgres DB, Edge Functions).
• Core features: symptom analyzer, health scorecard, AI chatbot, ultrasound scheduler, PCOS tracker, gamification, facial login.
File structure
• Top-level directories:
• public/ – static assets (robots.txt, index.html)
• src/ – all React source code
• supabase/ – configuration, database migrations, and Edge Functions
• src/components/ – reusable UI components and domain-specific widgets (e.g., SymptomTracker, AIChatbot).
• src/pages/ – route entry points (Index, Dashboard, NotFound).
• src/hooks/ – custom React hooks for stateful logic (useHealthScore, useProfile, etc.).
• src/integrations/supabase/ – client configuration and type definitions.
• Configuration files: tsconfig, vite.config.ts, tailwind.config.ts, eslint.config.js.
README for additional insights
• Confirms architecture: SPA hosted on a static host (Vercel).
• Supabase is used for authentication, database, and serverless logic.
• AI/ML logic lives partly in frontend utilities and partly in Supabase Edge Functions.
a. Main components
• Client Browser (React SPA)
• Static Hosting (Vercel/Netlify)
• Supabase Auth & Postgres Database
• Supabase Edge Functions (health score calculation, symptom analysis)
• AI/ML Logic (rule-based logic, future LLM integration)
• External Services (email/SMS reminders, calendar API)
b. Relationships & interactions
• User → React SPA (HTTPS)
• SPA → Supabase Auth (login/signup)
• SPA → Supabase Postgres (CRUD via Supabase client)
• SPA → Edge Functions (invoke via REST)
• Edge Functions → Database (read/write metrics)
• Edge Functions → AI logic modules
• Notifications → External services
c. Architectural patterns & principles
• SPA decoupled from backend services
• Supabase as BaaS (Auth, DB, Functions)
• Component-based UI with domain-specific and generic “ui/” modules
• Hooks for encapsulating stateful logic
d. Key technologies/frameworks
• React + TS + Vite
• Tailwind CSS + shadcn/ui
• Supabase Auth, Postgres, Edge Functions
• Node.js runtime for serverless functions
• Rule-based AI logic in JS/TS utilities
Detailed capture of essential elements
• SQL migration folder under Supabase to indicate versioned schema changes.