InfantCareCompass

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

InfantCareCompass

(★ 29)

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

InfantCareCompass Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<div align="center">
  <img src="client/public/logo.png" alt="InfantCareCompass Logo" width="150"/>
  
  <p align="center" style="font-style: italic; color: #FF69B4; font-size: 18px; margin-top: -10px;">
  "Guiding little steps, one health check at a time"
</p>
<br />
    <a href="https://infantcarecompass.live/"><strong>Explore the Live Demo »</strong></a>
    <br />
    <br />
<a href="https://github.com/Amarjha01/InfantCareCompass/issues">Report a Bug</a>
    ·
    <a href="https://github.com/Amarjha01/InfantCareCompass/issues">Request a Feature</a>
</p>
<img src="https://user-images.githubusercontent.com/74038190/212284100-561aa473-3905-4a80-b561-0d28506553ee.gif" width="100%">
</div>
  
  <div style="margin: 15px 0;">
    <img src="https://readme-typing-svg.herokuapp.com?size=35&color=FF69B4&width=800&lines=Welcome+to+InfantCareCompass+Grounds;Your+AI+Powered+Health+Companion;Monitors+and+Safeguarding+Future+steps;Smart+Insights+for+Parents+and+Monitoring" />
  </div>
  
  <div style="margin: 15px 0;">
    <img src="https://raw.githubusercontent.com/andreasbm/readme/master/assets/lines/rainbow.png" width="100%" height="10"/>
  </div>

</div>

## 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
<img width="756" height="540" alt="Untitled diagram _ Mermaid Chart-2025-10-06-005546" src="https://github.com/user-attachments/assets/f37071fd-4c5f-430d-9535-3d1fd088b743" />

## 🛠️ 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 |

</div>

<img src="https://user-images.githubusercontent.com/74038190/212284100-561aa473-3905-4a80-b561-0d28506553ee.gif" width="100%">
 
## 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 |

</div>

<img src="https://user-images.githubusercontent.com/74038190/212284100-561aa473-3905-4a80-b561-0d28506553ee.gif" width="100%">
 ---
 ## 🌟GSSoc

![GSSoC Logo](https://github.com/dimpal-yadav/Foodie/blob/main/images/GSSoC.png)

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

<details>
  <summary><b> Click to Expand Instructions</b></summary>
  <br>

<img src="https://user-images.githubusercontent.com/74038190/212284100-561aa473-3905-4a80-b561-0d28506553ee.gif" width="100%">
 
### 🛠 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/)

<img src="https://user-images.githubusercontent.com/74038190/212284100-561aa473-3905-4a80-b561-0d28506553ee.gif" width="100%">
 
### 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!

<img src="https://user-images.githubusercontent.com/74038190/212284100-561aa473-3905-4a80-b561-0d28506553ee.gif" width="100%">
 
### 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

```
</details>

<img src="https://user-images.githubusercontent.com/74038190/212284100-561aa473-3905-4a80-b561-0d28506553ee.gif" width="100%">
 
### 🤝 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.

<img src="https://user-images.githubusercontent.com/74038190/212284100-561aa473-3905-4a80-b561-0d28506553ee.gif" width="100%">
  
# Screenshot

## 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

<h3 align="center">🙏 Thanks to These Amazing People for Helping Build <strong>InfantCareCompass</strong>!</h3>

<h3 align="center">🔄 Auto-Updating with New Contributors!</h3>

<p align="center">
  Crafted with 💖 and lots of baby love by <b>Amarjha</b> and the <b>InfantCareCompass Crew</b>
  <br>
  <img src="https://user-images.githubusercontent.com/74038190/212284158-e840e285-664b-44d7-b79b-e264b5e54825.gif" width="400">
</p>

InfantCareCompass

InfantCareCompass Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

InfantCareCompass

InfantCareCompass Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README