Skip to content

Commit bf8a475

Browse files
authored
Updated Readme File
1 parent c318d62 commit bf8a475

1 file changed

Lines changed: 116 additions & 57 deletions

File tree

README.md

Lines changed: 116 additions & 57 deletions
Original file line numberDiff line numberDiff line change
@@ -1,103 +1,162 @@
1-
# CareSync Web
1+
# 🏥 CareSync
22

3-
Accessible healthcare web app for medicine tracking, symptom checking, and smart referrals.
3+
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
4+
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com)
5+
[![React](https://img.shields.io/badge/React-18-61DAFB?logo=react\&logoColor=black)](https://reactjs.org/)
6+
[![Vercel](https://img.shields.io/badge/Deployed-Vercel-000000?logo=vercel\&logoColor=white)](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.
410
511
---
612

7-
## 🚀 About
13+
## 🌐 Live Demo
814

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/)**
1116

1217
---
1318

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.
1522

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.
2124

2225
---
2326

24-
## 👥 Team
27+
## ✨ Key Features
2528

26-
This project was developed collaboratively during a hackathon by our team:
29+
### 💊 Medicine Tracker
2730

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
3033

31-
---
34+
### 🔍 AI-Powered Symptom Checker
3235

33-
## 🌐 Live Demo
36+
* Input symptoms to receive possible conditions
37+
* Basic risk assessment and suggested treatments
3438

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
3748

3849
---
3950

4051
## 🛠️ Tech Stack
4152

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
4763

4864
---
4965

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**
5178

79+
```bash
80+
git clone https://github.com/vallabhatech/CareSync.git
81+
cd CareSync
5282
```
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
6994
```
7095

96+
The app will open automatically at:
97+
👉 **[http://localhost:3000](http://localhost:3000)**
98+
7199
---
72100

73-
## 🏁 Getting Started
101+
## ⚡ Quick Deploy
102+
103+
Deploy your own instance instantly using Vercel:
74104

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+
[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new)
85106

86107
---
87108

88-
## 📄 License
109+
## 🗺️ Roadmap
89110

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
91116

92117
---
93118

94119
## 🤝 Contributing
95120

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
98145

99146
---
100147

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)
102152

153+
---
154+
155+
## 📄 License
156+
157+
Distributed under the **MIT License**.
158+
See the `LICENSE` file for more information.
159+
160+
---
103161

162+
⭐ If you like this project, don’t forget to star the repo!

0 commit comments

Comments
 (0)