✨Empowering communities through accessible healthcare information, mental wellness resources, and real-time support.✨
📖 Overview • ✨ Features • 🏗️ Architecture • 🚀 Get Started • 🤝 Support
Inspired by the SAATHI initiative at IIT Madras, Sehat Saathi bridges the critical gap in healthcare accessibility. By combining technology with a human-centric approach, we provide a localized, multi-language guide for physical and mental well-being.
The platform is architected for speed, modularity, and offline-first reliability.
Sehat Saathi (Health Core)
┃
┣━━ 🧩 UI/UX Layer (React + Tailwind)
┃ ┣━━ 🌍 Multilingual Module .... [HINDI / ENGLISH Support]
┃ ┣━━ 🧠 Mental Wellness Hub .... [Resource Discovery]
┃ ┗━━ 📱 Responsive Interface ... [Mobile/Desktop Sync]
┃
┣━━ 🛠️ Logic Engine
┃ ┣━━ 🔍 Resource Search ........ [Optimized Filtering]
┃ ┣━━ 🏥 Healthcare Directory ... [Facility Mapping]
┃ ┗━━ 💬 Support Connect ........ [Direct Link Systems]
┃
┣━━ ⚡ Infrastructure (Vite)
┃ ┣━━ 📦 Optimized Bundling ..... [Sub-second Loads]
┃ ┗━━ 🛡️ Type-Safety (TS) ....... [Strict Data Integrity]
┃
┗━━ 📊 Analytics & Impact
┗━━ 📝 Feedback Loop .......... [User Growth Tracking]
---
🌟 WHY SEHAT SAATHI?
In many communities, healthcare information and mental wellness resources are often difficult to access or shrouded in stigma. **Sehat Saathi** (meaning "Health Companion") aims to:
- **Democratize Wellness**: Make health resources accessible to everyone, regardless of their technical background.
- **Multi-language Support**: Provide guidance in regional languages including Hindi, Bengali, Marathi, Bhojpuri, and Maithili.
- **Reduce Stigma**: Offer a safe, digital space to explore wellness options and track symptoms.
- **Empower through Information**: Connect users with government schemes (Sarkari Yojana) and nearby medical facilities.
---
✨ KEY FEATURES
- 🩺 **Symptom Tracker**: Record and monitor health symptoms with a simple, intuitive interface. Uses a rule-based triage system to provide immediate feedback.
- 🤖 **AI Health Assistant**: Get instant guidance and answers to common health queries through a localized chat interface.
- 💊 **Medicine Store**: Browse and purchase affordable medicines with a seamless cart and checkout experience.
- 🏛️ **Sarkari Yojana**: Stay updated on government health schemes, eligibility criteria, and application processes.
- 🏥 **Nearby Hospitals**: Locate Primary Health Centres (PHC), Community Health Centres (CHC), and District Hospitals using geolocation.
- 🌍 **Multi-language Support**: Fully localized experience for diverse linguistic needs across India.
- 📱 **Progressive Design**: Fully responsive, mobile-first design optimized for low-bandwidth environments.
---
🌐 LOCALIZATION
Sehat Saathi is built to be inclusive. We currently support the following languages:
| Language | Code | Status |
|----------|------|--------|
| Hindi (हिन्दी) | `hi` | ✅ Fully Supported |
| English | `en` | ✅ Fully Supported |
| Bengali (বাংলা) | `bn` | ✅ Fully Supported |
| Marathi (मराठी) | `mr` | ✅ Fully Supported |
| Bhojpuri (भोजपुरी) | `bho` | ✅ Fully Supported |
| Maithili (मैथिली) | `mai` | ✅ Fully Supported |
---
⚙️ TECHNICAL HIGHLIGHTS
- **Rule-Based Triage**: The symptom tracker uses a sophisticated evaluator (`src/lib/triage/evaluator.ts`) that matches user symptoms against predefined medical rules to suggest urgency levels.
- **Accessible UI**: Built using [Radix UI](https://www.radix-ui.com/) primitives via [shadcn/ui](https://ui.shadcn.com/), ensuring high accessibility (WAI-ARIA) standards.
- **Type Safety**: 100% TypeScript coverage for robust state management and API interactions.
- **Performance**: Optimized asset delivery and fast refresh using Vite and Bun, ensuring the app remains lightweight for mobile users.
---
🛠️ TECH STACK
| Technology | Usage | Badge |
|------------|-------|-------|
| Frontend Framework | Core | React |
| Programming Language | Core | TypeScript |
| Build Tool | Core | Vite |
| Styling Framework | Core | Tailwind CSS |
| UI Components | UI | Shadcn/ui |
| Icons | UI | Lucide React |
| State Management | Data | TanStack Query |
| Routing | Navigation | React Router |
| Maps | Features | Leaflet |
| Data Visualization | Features | Recharts |
| Backend Runtime | Server | Node.js |
| Backend Framework | Server | Express |
| Database | Data | MongoDB |
| Real-time Communication | Communication | Socket.io |
| Authentication | Security | JWT |
### Tech Stack Graph
```mermaid
graph TD
A[Frontend] --> B[React]
A --> C[TypeScript]
A --> D[Vite]
A --> E[Tailwind CSS]
A --> F[Shadcn/ui]
A --> G[Lucide React]
A --> H[TanStack Query]
A --> I[React Router]
A --> J[Leaflet]
A --> K[Recharts]
L[Backend] --> M[Node.js]
L --> N[Express]
L --> O[MongoDB]
L --> P[Socket.io]
L --> Q[JWT]
B --> R[User Interface]
C --> R
D --> R
E --> R
F --> R
G --> R
H --> R
I --> R
J --> R
K --> R
M --> S[API Server]
N --> S
O --> S
P --> S
Q --> S
🚀 GETTING STARTED
⭐ Prerequisites:
- Node.js (v18.x or higher)
- Bun (Optional, but recommended for speed)
⭐ Installation:
-
Clone the Repository
git clone https://github.com/Naman-iitm/sehat-saathi-guide.git cd sehat-saathi-guide -
Install Dependencies
bun install # or npm install -
Start Development Server
bun run dev # or npm run dev
The app will be live at http://localhost:5173/.
- Select Language: On your first visit, choose your preferred language from the onboarding screen.
- Track Symptoms: Go to the "Symptom Tracker" to log any health issues. The system will categorize them and provide initial guidance.
- Consult AI: Use the "AI Assistant" for quick questions about common ailments or wellness tips.
- Find Care: Use the "Nearby Hospitals" feature to find the closest government health facility based on your current location.
- Explore Schemes: Check the "Sarkari Yojana" section to see if you are eligible for any free healthcare services.
sehat-saathi-guide/
├── public/ # Static assets
├── screenshots/ # UI screenshots for documentation
├── src/ # Source code
│ ├── components/ # React components (AIAssistant, Cart, etc.)
│ │ └── ui/ # shadcn/ui base components
│ ├── contexts/ # Auth, Language, and Cart contexts
│ ├── data/ # Static data for tips, medicines, and schemes
│ ├── hooks/ # Custom React hooks
│ ├── lib/ # Utility functions and triage logic
│ ├── pages/ # Main page views (Index, NotFound)
│ ├── types/ # TypeScript interfaces
│ ├── App.tsx # Main application component & routing
│ └── index.css # Global styles & Tailwind imports
├── components.json # shadcn/ui configuration
├── package.json # Project dependencies and scripts
├── tailwind.config.ts # Tailwind CSS configuration
└── vite.config.ts # Vite configuration
Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.
-
Fork the Repository: Click the 'Fork' button at the top right of this page to create a copy of the repository in your account.
-
Clone your Fork:
git clone https://github.com/YOUR_USERNAME/sehat-saathi-guide.git
-
Create a Feature Branch: Always create a new branch for your changes (e.g.,
feature/AmazingFeature).git checkout -b feature/AmazingFeature
-
Commit your Changes: Write clear and concise commit messages (e.g.,
Add some AmazingFeature).git commit -m 'Add some AmazingFeature' -
Push to your Fork:
git push origin feature/AmazingFeature
-
Open a Pull Request: Go to the original repository and click 'New Pull Request'.
- ✅ Read documentation thoroughly before contributing
- ✅ Follow code style and project structure
- ✅ Write descriptive commit messages
- ✅ Test your changes before submitting PR
- ✅ Be respectful and collaborative
- ✅ Ask questions if you're unsure about anything
- ❌ Don't spam with multiple PRs for same issue
- ❌ Don't copy code without understanding
- ❌ Don't make unnecessary changes
- ❌ Don't ignore code review feedback
- ❌ Don't forget to update documentation when needed
| Level | Description | Points | Badge |
|---|---|---|---|
| 🥉 Beginner | Fix typos, update docs, minor bug fixes | 5-10 | |
| 🥈 Intermediate | Add features, improve UI/UX, performance | 15-25 | |
| 🥇 Advanced | Major features, architecture improvements | 30-50 |
Distributed under the MIT License. See LICENSE for more information (coming soon).
Naman Jha - GitHub Profile
Project Link: https://github.com/Naman-iitm/sehat-saathi-guide
Made with ❤️ for a healthier community