https://github.com/amarjha01/infantcarecompass
InfantCareCompass is a dedicated platform designed to simplify childcare management for modern parents. Balancing the joys and challenges of parenting, this application empowers users to efficiently track their child’s healthcare needs, particularly focusing on vaccination schedules, educational resources, and more. Discord - available soon
https://github.com/amarjha01/infantcarecompass
cloudinary expressjs gssoc25 mongodb nodejs reactjs tailwindcss webrtc-video
Last synced: about 2 months ago
JSON representation
InfantCareCompass is a dedicated platform designed to simplify childcare management for modern parents. Balancing the joys and challenges of parenting, this application empowers users to efficiently track their child’s healthcare needs, particularly focusing on vaccination schedules, educational resources, and more. Discord - available soon
- Host: GitHub
- URL: https://github.com/amarjha01/infantcarecompass
- Owner: Amarjha01
- License: mit
- Created: 2024-12-22T10:45:03.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2025-11-09T09:00:24.000Z (6 months ago)
- Last Synced: 2026-01-03T14:21:48.706Z (5 months ago)
- Topics: cloudinary, expressjs, gssoc25, mongodb, nodejs, reactjs, tailwindcss, webrtc-video
- Language: JavaScript
- Homepage: http://infantcarecompass.live/
- Size: 7.92 MB
- Stars: 32
- Watchers: 1
- Forks: 111
- Open Issues: 95
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
"Guiding little steps, one health check at a time"
Explore the Live Demo »
Report a Bug
·
Request a Feature
## Overview
**InfantCareCompass** isn’t just an app - it’s your **digital parenting partner**.
Designed especially for **new and busy parents**, it makes managing your child’s healthcare effortless & stress-free.
From **tracking vaccinations** to **learning childcare essentials**,
we bring you a **one-stop compass** that points towards **better, smarter parenting**.
## Vision (concise)
Make InfantCareCompass the trusted, easy‑to‑use companion for new and expectant parents — delivering evidence‑based infant care guidance, simple tracking tools, and connections to local resources so families feel confident and supported.
### What Makes Us Special?
**Vaccination Tracking** ---> Get timely reminders so you never miss a dose.
**Childcare Education** ---> Learn from trusted resources & expert-backed guides.
**User-Friendly Design** ---> A clean, modern UI that’s simple enough for everyone.
**Future-Ready Vision** ---> AI guidance, video consults, multilingual support & more!
## Project flowchart
## 🛠️ Technologies Used
| Tech | Purpose |
|---------|------------|
| **React.js + Vite** | Lightning-fast frontend development |
| **TailwindCSS** | Sleek, modern, and responsive styling |
| **Node.js + Express** | Powering backend APIs with ease |
| **MongoDB** | Secure, scalable database for user data |
| **Cloudinary** | Smart image storage & management |
## Future Goals
| Goal | Description |
|---------|----------------|
| **UI/UX Enhancements** | Smooth, responsive design for all devices and users |
| **Integrated Video Conferencing** | Real-time consultations with pediatricians via ZegoCloud/WebRTC |
| **AI-Based First Aid Guidance** | Instant AI suggestions for minor health issues & parenting tips |
| **Smart Vaccination Notifications** | Personalized reminders based on age, location & history |
| **Parenting Resource Center** | Doctor-written articles, tips & community Q&A hub |
| **Multi-language Support** | Regional Indian languages for wider accessibility |
| **Role-Based Access & Security** | Data privacy for doctors, parents & admins |
| **Analytics Dashboard** | Track vaccination, user engagement & consultations |
---
## 🌟GSSoc
🌟 **Exciting News...**
🚀 This project is now an official part of GirlScript Summer of Code – GSSoC'25! 💻 We're thrilled to welcome contributors from all over India and beyond to collaborate, build, and grow *InfantCareCompass!* Let’s make learning and career development smarter – together! 🌟
GSSoC is one of India’s **largest 3-month-long open-source programs** that encourages developers of all levels to contribute to real-world projects while learning, collaborating, and growing together.
🌈 With **mentorship, community support**, and **collaborative coding**, it's the perfect platform for developers to:
- ✨ Improve their skills
- 🤝 Contribute to impactful projects
- 🏆 Get recognized for their work
- 📜 Receive certificates and swag!
🎉 **I can’t wait to welcome new contributors** from GSSoC 2025 to this InfantCareCompass project family! Let's build, learn, and grow together — one commit at a time.
---
## Getting Started
Click to Expand Instructions
### 🛠 Prerequisites
Before you begin, ensure you have the following installed and set up:
- **Node.js** – Install the latest stable version from [Node.js Official Website](https://nodejs.org/)
- **MongoDB** – Either a local instance or a cloud MongoDB URI via [MongoDB Atlas](https://www.mongodb.com/cloud/atlas)
- **Cloudinary Account** – For image storage & management, sign up at [Cloudinary](https://cloudinary.com/)
### Installation
1. **Clone the repository:**
```bash
git clone https://github.com/Amarjha01/InfantCareCompass.git
cd InfantCareCompass
2. **Install dependencies:**
```bash
# Install server dependencies
npm install
# Navigate to the client directory and install dependencies
cd client
npm install
```
4. **Set Up Environment Variables**
Go back to the root directory, create a `.env` file, and add the following keys.
```bash
# Navigate back to the root directory if you are in /client
cd ..
touch .env
```
Your `.env` file should look like this:
```env
PORT=5000
MONGO_URI=your_mongodb_uri
CLOUDINARY_CLOUD_NAME=your_cloudinary_cloud_name
CLOUDINARY_API_KEY=your_cloudinary_api_key
CLOUDINARY_API_SECRET=your_cloudinary_api_secret
```
5. **Run the Application**
You'll need two separate terminal windows for this step.
* **Terminal 1: Start the Backend Server** (from the root directory)
```bash
npm start
```
* **Terminal 2: Start the Frontend Development Server**
```bash
# Navigate to the client directory
cd client
npm run dev
```
The application should now be running on your local machine!
### Project Structure
```bash
InfantCareCompass/
├── .github/
│ ├── ISSUE_TEMPLATE/
│ └── workflows/
│ └── FUNDING.yml
├── client/
│ ├── public/
│ │ └── logo.png
│ ├── src/
│ │ ├── api/
│ │ ├── common/
│ │ ├── components/
│ │ ├── helpers/
│ │ ├── pages/
│ │ ├── routes/
│ │ ├── store/
│ │ ├── App.css
│ │ ├── App.jsx
│ │ ├── iceServers.js
│ │ ├── index.css
│ │ └── main.jsx
│ ├── .env
│ ├── .gitignore
│ ├── eslint.config.js
│ ├── index.html
│ ├── package-lock.json
│ ├── package.json
│ ├── postcss.config.js
│ ├── README.md
│ ├── tailwind.config.js
│ └── vite.config.js
├── server/
│ ├── config/
│ ├── controller/
│ ├── middleware/
│ ├── models/
│ ├── routes/
│ ├── utils/
│ ├── .gitignore
│ ├── index.js
│ ├── package-lock.json
│ └── package.json
├── .gitignore
├── LICENSE
├── package-lock.json
├── package.json
├── PULL_REQUEST_TEMPLATE.md
└── README.md
```
### 🤝 Contributing
Contributions are what make the **open-source community** such an amazing place to **learn, inspire, and create**.
We **love** receiving contributions of all kinds - whether it's fixing bugs, adding new features, improving documentation, or just giving feedback!
#### How You Can Contribute
1. **Star the repo** to show your support.
2. **Report bugs** by opening an issue.
3. **Add features** by submitting pull requests.
4. **Improve docs** to help other developers.
5. **Share feedback** to make the project even better.
> Before contributing, please make sure to **read the [Code of Conduct](./CODE_OF_CONDUCT.md)** and **[Contribution Guidelines](./CONTRIBUTING.md)** for a smooth collaboration experience.
### License
This project is licensed under the [MIT License](LICENSE).
You’re free to use, modify, and share this software under the license terms.
### 🛠️ Troubleshooting (Quickfix)
- Site won’t load: check internet, try incognito/clear cache, or check status page.
- Sign up / login fail: confirm email verification, try password reset, check spam for verification email.
- Missing content or images: refresh, ensure you have the correct access/role, and try a different browser.
- Form submission error: validate required fields, check browser console and network tab for errors.
- Push/notification issues: confirm device/browser permissions.
- Still stuck: collect reproduction steps, browser + device, screenshots and console/network logs; open an issue or contact support.
# Screenshot
View
## Benefits for contributors
- Real impact: help parents access reliable infant-care guidance.
- Learn & grow: work with modern web stack and production workflows.
- Clear onboarding: issues labeled for beginners and maintainers provide guidance.
- Recognition: contributors listed in README/contributors and credited in release notes.
- Flexible tasks: implement features, fix bugs, improve docs, or add tests.
# Contributors
🙏 Thanks to These Amazing People for Helping Build InfantCareCompass!
🔄 Auto-Updating with New Contributors!
Crafted with 💖 and lots of baby love by Amarjha and the InfantCareCompass Crew
