ClinIQ is an innovative open-source health-tech platform that leverages AI to provide accurate symptom analysis and doctor discovery—all in one place. Our goal is to make healthcare more accessible and user-friendly for everyone.
ELUSOC 2026 Official Project: This repo is officially selected and actively maintained for open-source collaboration.
Before claiming an issue or submitting a PR, contributors are expected to:
- ⭐ Star this repository
- 👀 Follow the maintainer on GitHub: https://github.com/akshay0611
- 🍴 Fork the repository
- 📖 Read CONTRIBUTING.md
These steps help support the project and keep contributors informed about updates and announcements.
Homepage:
Symptom Checker:
Millions face delays and confusion when accessing healthcare. Getting a preliminary understanding of symptoms can be difficult, and finding the right specialist is often a challenge.
- 🧠 AI Symptom Checker: Get instant, personalized health insights.
- 👩⚕️ Doctor Directory: Find verified specialists by expertise.
- 💬 Chat Interface: An interactive way to get feedback on symptoms.
- 📱 Responsive UI: A modern and smooth user experience on any device.
- 🏥 Hospital Locator: Find nearby hospitals using your PIN code.
| Layer | Technologies |
|---|---|
| Frontend | React.js, TypeScript, Tailwind CSS, Framer Motion |
| Backend | Supabase |
| Database | Supabase (PostgreSQL) |
| AI API | Gemini API |
📐 View Full Architecture Overview →
git clone https://github.com/YOUR_USERNAME/ClinIQ.git
cd ClinIQ
npm install
cp .env.example .env
npm run devThen open http://localhost:5173.
For complete setup and troubleshooting: SETUP.md
- Create a free project on Supabase.
- Go to the SQL Editor in your Supabase dashboard.
- Copy the content of
supabase/schema.sqland run it to create the core tables + policies. - Get your
VITE_SUPABASE_URLandVITE_SUPABASE_ANON_KEYfrom Project Settings > API and add them to your.envfile.
VITE_GEMINI_API_KEYis optional — the symptom checker falls back to mock results without it.
These tiers are project guidance for onboarding and issue complexity.
They are not official ELUSOC points/rank rules.
| Tier | Focus Area | Typical Tasks |
|---|---|---|
| 🟩 Medical Intern | First contributions | README/docs updates, typo fixes, small UI polish |
| 🟦 Resident Doctor | Feature and bug work | Component improvements, bug fixes, API/UI refinements |
| 🟪 Chief Surgeon | System-level changes | Architecture refactors, performance work, deeper integrations |
As Project Admin during Hacktoberfest 2025 and ELUSOC 2026, I spearheaded both the technical development and community growth of ClinIQ.
- Full-Stack Architecture: Designed and built the entire system using React, TypeScript, Supabase, and Gemini AI—from database schema to UI components
- Core Features: Developed the AI symptom checker, doctor discovery system, appointment booking flow, and role-based dashboards for patients and doctors
- Database Engineering: Architected PostgreSQL schema with proper relationships, Row Level Security (RLS) policies, and data integrity constraints
- UI/UX Development: Created responsive, accessible interfaces with Tailwind CSS and smooth animations using Framer Motion
- Open Source Leadership: Managed issues and pull requests, maintaining code quality while welcoming diverse contributions from the community
- Contributor Support: Mentored developers (including first-time contributors) through code reviews, issue discussions, and technical guidance
- Documentation: Wrote clear setup guides, contributing guidelines, and inline code documentation to lower the barrier for new contributors
- Deployment & DevOps: Set up CI/CD pipeline and production deployment, ensuring the platform is accessible to real users
We welcome contributors of all levels.
Start with open issues, claim one, and submit a focused PR with clean commit history.
- Contribution guide: CONTRIBUTING.md
- Issues board: GitHub Issues
feature/feature-name— For new featuresfix/bug-description— For bug fixesdocs/update-description— For documentation updatesrefactor/component-name— For code refactoring
good first issue— Ideal for newcomerselusoc— Issues for ELUSOC 2026 contributorsbug— Something isn't working as expectedUI/UX— Involves improving interface or user experience
- 📊 Advanced Dashboards: For patients, doctors, and admins with actionable insights.
- 🔐 Enhanced Security: End-to-end encryption and role-based access controls.
- 🔔 Real-time Notifications: Appointment alerts and health reminders.
This project is licensed under the MIT License.
See LICENSE for details.
If ClinIQ helps or inspires you, drop a star and share it with fellow builders.
Built with care by Akshay Kumar
Connect with me:
