|
1 | | -# CareSync Web |
| 1 | +# 🏥 CareSync |
2 | 2 |
|
3 | | -Accessible healthcare web app for medicine tracking, symptom checking, and smart referrals. |
| 3 | +[](https://opensource.org/licenses/MIT) |
| 4 | +[](http://makeapullrequest.com) |
| 5 | +[](https://reactjs.org/) |
| 6 | +[](https://care-sync-iota.vercel.app/) |
| 7 | + |
| 8 | +> **Accessible healthcare made simple.** |
| 9 | +> A smart, modular web application for medicine tracking, symptom checking, and clinic discovery. |
4 | 10 |
|
5 | 11 | --- |
6 | 12 |
|
7 | | -## 🚀 About |
| 13 | +## 🌐 Live Demo |
8 | 14 |
|
9 | | -**CareSync** was built as a team project during a hackathon to empower users with easy, accessible healthcare tools. |
10 | | -Our goal: make health management simple, smart, and available to everyone. |
| 15 | +👉 **[https://care-sync-iota.vercel.app/](https://care-sync-iota.vercel.app/)** |
11 | 16 |
|
12 | 17 | --- |
13 | 18 |
|
14 | | -## ✨ Features |
| 19 | +## 📖 About |
| 20 | + |
| 21 | +**CareSync** empowers individuals to take control of their health management. Built to be accessible and intuitive, it solves the problem of scattered healthcare information by centralizing medicine reminders, symptom analysis, and local medical resource discovery into one cohesive platform. |
15 | 22 |
|
16 | | -- **Medicine Tracker:** Add, view, and manage your medicines with daily reminders. |
17 | | -- **Symptom Checker:** Enter symptoms, get possible conditions, risk levels, causes, and solutions. |
18 | | -- **Clinics Nearby:** Find clinics/hospitals near your location and view them on Google Maps. |
19 | | -- **Modern UI:** Consistent, responsive, and accessible design across all pages. |
20 | | -- **Settings:** Manage your profile and notification preferences. |
| 23 | +Whether you are managing a chronic condition or just need a quick check-up on symptoms, CareSync acts as your personal health companion. |
21 | 24 |
|
22 | 25 | --- |
23 | 26 |
|
24 | | -## 👥 Team |
| 27 | +## ✨ Key Features |
25 | 28 |
|
26 | | -This project was developed collaboratively during a hackathon by our team: |
| 29 | +### 💊 Medicine Tracker |
27 | 30 |
|
28 | | -- [vallabhatech](https://github.com/vallabhatech) |
29 | | -- [HazariThanusree-2005](https://github.com/HazariThanusree-2005) |
| 31 | +* Add and manage daily prescriptions |
| 32 | +* Set custom reminders so you never miss a dose |
30 | 33 |
|
31 | | ---- |
| 34 | +### 🔍 AI-Powered Symptom Checker |
32 | 35 |
|
33 | | -## 🌐 Live Demo |
| 36 | +* Input symptoms to receive possible conditions |
| 37 | +* Basic risk assessment and suggested treatments |
34 | 38 |
|
35 | | -You can try CareSync online here: |
36 | | -https://care-sync-iota.vercel.app/ |
| 39 | +### 🏥 Clinic Locator |
| 40 | + |
| 41 | +* Find nearby hospitals and clinics using geolocation |
| 42 | +* Interactive map integration using OpenStreetMap |
| 43 | + |
| 44 | +### 📱 Responsive Design |
| 45 | + |
| 46 | +* Optimized for mobile, tablet, and desktop |
| 47 | +* Built using Material UI and Bootstrap |
37 | 48 |
|
38 | 49 | --- |
39 | 50 |
|
40 | 51 | ## 🛠️ Tech Stack |
41 | 52 |
|
42 | | -- React 18 |
43 | | -- Material-UI (MUI) |
44 | | -- OpenStreetMap Nominatim API |
45 | | -- Custom CSS |
46 | | -- Bootstrap |
| 53 | +### Frontend |
| 54 | + |
| 55 | +* **React 18** – Component-based UI |
| 56 | +* **Material UI (MUI)** – Modern, accessible UI components |
| 57 | +* **Bootstrap** – Grid system and layout utilities |
| 58 | + |
| 59 | +### APIs & Services |
| 60 | + |
| 61 | +* **OpenStreetMap (Nominatim)** – Geocoding and location services |
| 62 | +* **Vercel** – Deployment and hosting |
47 | 63 |
|
48 | 64 | --- |
49 | 65 |
|
50 | | -## 📁 Project Structure |
| 66 | +## 🚀 Getting Started |
| 67 | + |
| 68 | +Follow these instructions to set up the project locally. |
| 69 | + |
| 70 | +### Prerequisites |
| 71 | + |
| 72 | +* **Node.js** v16 or higher |
| 73 | +* **npm** v8 or higher |
| 74 | + |
| 75 | +### Installation |
| 76 | + |
| 77 | +1. **Clone the repository** |
51 | 78 |
|
| 79 | +```bash |
| 80 | +git clone https://github.com/vallabhatech/CareSync.git |
| 81 | +cd CareSync |
52 | 82 | ``` |
53 | | -src/ |
54 | | - App.jsx |
55 | | - index.js |
56 | | - theme.js |
57 | | - index.css |
58 | | - assets/ |
59 | | - components/ |
60 | | - Navbar.jsx |
61 | | - Footer.jsx |
62 | | - ParticlesBG.jsx |
63 | | - pages/ |
64 | | - Dashboard.jsx |
65 | | - MedicineTracker.jsx |
66 | | - SymptomChecker.jsx |
67 | | - ClinicsNearby.jsx |
68 | | - Settings.jsx |
| 83 | + |
| 84 | +2. **Install dependencies** |
| 85 | + |
| 86 | +```bash |
| 87 | +npm install |
| 88 | +``` |
| 89 | + |
| 90 | +3. **Start the development server** |
| 91 | + |
| 92 | +```bash |
| 93 | +npm start |
69 | 94 | ``` |
70 | 95 |
|
| 96 | +The app will open automatically at: |
| 97 | +👉 **[http://localhost:3000](http://localhost:3000)** |
| 98 | + |
71 | 99 | --- |
72 | 100 |
|
73 | | -## 🏁 Getting Started |
| 101 | +## ⚡ Quick Deploy |
| 102 | + |
| 103 | +Deploy your own instance instantly using Vercel: |
74 | 104 |
|
75 | | -1. **Install dependencies:** |
76 | | - ```bash |
77 | | - npm install |
78 | | - ``` |
79 | | -2. **Start the app:** |
80 | | - ```bash |
81 | | - npm start |
82 | | - ``` |
83 | | -3. **Open in browser:** |
84 | | - Go to [http://localhost:3000](http://localhost:3000) |
| 105 | +[](https://vercel.com/new) |
85 | 106 |
|
86 | 107 | --- |
87 | 108 |
|
88 | | -## 📄 License |
| 109 | +## 🗺️ Roadmap |
89 | 110 |
|
90 | | -MIT License |
| 111 | +* [ ] User authentication (Login / Signup) |
| 112 | +* [ ] Backend integration for persistent user data |
| 113 | +* [ ] Push notifications for medicine reminders |
| 114 | +* [ ] Telemedicine appointment booking |
| 115 | +* [ ] Multi-language support |
91 | 116 |
|
92 | 117 | --- |
93 | 118 |
|
94 | 119 | ## 🤝 Contributing |
95 | 120 |
|
96 | | -Pull requests are welcome! |
97 | | -For major changes, please open an issue first to discuss what you would like to change. |
| 121 | +Contributions are what make the open-source community grow and thrive. Any contribution you make is **greatly appreciated**. |
| 122 | + |
| 123 | +### Steps to Contribute |
| 124 | + |
| 125 | +1. Fork the project |
| 126 | +2. Create your feature branch |
| 127 | + |
| 128 | +```bash |
| 129 | +git checkout -b feature/AmazingFeature |
| 130 | +``` |
| 131 | + |
| 132 | +3. Commit your changes |
| 133 | + |
| 134 | +```bash |
| 135 | +git commit -m "Add AmazingFeature" |
| 136 | +``` |
| 137 | + |
| 138 | +4. Push to the branch |
| 139 | + |
| 140 | +```bash |
| 141 | +git push origin feature/AmazingFeature |
| 142 | +``` |
| 143 | + |
| 144 | +5. Open a Pull Request |
98 | 145 |
|
99 | 146 | --- |
100 | 147 |
|
101 | | -**CareSync** — Empowering communities through accessible healthcare solutions. |
| 148 | +## 👥 Team |
| 149 | + |
| 150 | +* **Surishetty Harivallabha Sai** – [@vallabhatech](https://github.com/vallabhatech) |
| 151 | +* **Hazari Thanusree** – [@HazariThanusree-2005](https://github.com/HazariThanusree-2005) |
102 | 152 |
|
| 153 | +--- |
| 154 | + |
| 155 | +## 📄 License |
| 156 | + |
| 157 | +Distributed under the **MIT License**. |
| 158 | +See the `LICENSE` file for more information. |
| 159 | + |
| 160 | +--- |
103 | 161 |
|
| 162 | +⭐ If you like this project, don’t forget to star the repo! |
0 commit comments