"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
• MongoDB – Either a local instance or a cloud MongoDB URI via MongoDB Atlas
• Cloudinary Account – For image storage & management, sign up at Cloudinary

Installation

1. Clone the repository:

   git clone https://github.com/Amarjha01/InfantCareCompass.git
   cd InfantCareCompass
   

2. Install dependencies:

   # Install server dependencies
   npm install
   
   # Navigate to the client directory and install dependencies
   cd client
   npm install

3. Set Up Environment Variables Go back to the root directory, create a .env file, and add the following keys.

   # Navigate back to the root directory if you are in /client
   cd ..
   touch .env

   Your .env file should look like this:

   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

4. Run the Application You'll need two separate terminal windows for this step.

   • Terminal 1: Start the Backend Server (from the root directory)

     npm start

   • Terminal 2: Start the Frontend Development Server

     # Navigate to the client directory
     cd client
     npm run dev

The application should now be running on your local machine!

Project Structure

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 and Contribution Guidelines for a smooth collaboration experience.

License

This project is licensed under the MIT 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