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.
Note: This project was successfully launched during Hacktoberfest 2025 and continues to welcome contributions from the open-source community.
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.
ClinIQ addresses these challenges by providing:
- 🧠 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.
ClinIQ is a Vite + React + TypeScript app. Supabase is required for auth + profiles.
git clone https://github.com/YOUR_USERNAME/ClinIQ.git
cd ClinIQ
npm install
cp .env.example .env
npm run devThen open http://localhost:5173.
See SETUP.md for:
- Supabase project setup + required SQL
- Required vs optional environment variables
- Troubleshooting and FAQs
ClinIQ uses Supabase for authentication and core data. To set up the database:
- 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.
Notes:
VITE_GEMINI_API_KEYis optional (symptom checker can fall back to mock results).
Open http://localhost:5173 in your browser to view the app.
As Project Admin during Hacktoberfest 2025, I spearheaded both the technical development and community growth of ClinIQ. Here's what that looked like:
- 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 during Hacktoberfest, 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
This project taught me how to balance technical excellence with community building—writing clean, maintainable code while fostering an inclusive environment for contributors of all skill levels. The result is a production-ready healthcare platform that's both technically sound and community-driven.
We welcome contributions from developers of all skill levels! Whether you're fixing bugs, adding features, or improving documentation, your help makes ClinIQ better.
Please read our CONTRIBUTING.md for detailed instructions.
- Fork the repository and create a new branch for your feature/fix
- Make your changes following our code style and conventions
- Test thoroughly to ensure nothing breaks
- Submit a pull request with a clear description of your changes
- Respond to feedback from maintainers during code review
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 newcomers.hacktoberfest: Issues for Hacktoberfest contributors.bug: Something isn’t working as expected.UI/UX: Involves improving interface or user experience.
| Layer | Technologies |
|---|---|
| Frontend | React.js, TypeScript, Tailwind CSS, Framer Motion |
| Backend | Supabase |
| Database | Supabase (PostgreSQL) |
| AI API | Gemini API |
📐 View Full Architecture Overview →
- 📊 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 the LICENSE file for details.
If you find ClinIQ helpful, please give it a ⭐ star on GitHub!
For questions or feedback, reach out to akshay.allen26200@gmail.com