Skip to content

A smart, automated vaccination tracking system designed to ensure every child gets their vaccines on time.

Notifications You must be signed in to change notification settings

Enigma-CSE/VaxTrack

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

1 Commit
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🩺 VaxTrack - Child Vaccination Reminder System

A smart, automated vaccination tracking system designed to ensure every child gets their vaccines on time.

VaxTrack Illustration

🌟 Overview

VaxTrack is a simple yet powerful web application designed to help parents track their child's vaccination schedule. Using a clean, glassmorphism-inspired interface, parents can register their child and receive automated email reminders when vaccines are due.

This project simulates a minute-by-minute demo of a child's growth to showcase the reminder system in real-time presentations.


πŸ›  Tech Stack

Frontend (Crafted by Us)

  • HTML5: Semantic and structured layout.
  • CSS3 (Vanilla): Custom "Glassmorphism" design system, responsive grid layouts, and smooth animations.
  • JavaScript (ES6+): Dynamic DOM manipulation, fetch API integration for asynchronous data handling.

Backend (Architected by Senior Dev)

  • Node.js: Robust runtime environment.
  • Express.js: Fast web framework for handling API routes (/register, /login, /update).
  • Nodemailer: Enterprise-grade email transport service using standard SMTP protocols (SSL/TLS).
  • File-System Persistence: Lightweight JSON-based database/storage for zero-overhead deployment.

πŸš€ Features

  • ⏱️ Live Demo Mode: Simulates months of growth in mere minutes. Watch the timeline update instantly!
  • πŸ“§ Automated Reminders: Background scheduler checks status every 10 seconds and emails parents if a vaccine is missed.
  • πŸ’Ž Premium Design: A modern, clean UI with focus on readability and user experience.
  • βœ… Progress Tracking: Interactive dashboard to mark vaccines as completed.
  • πŸ’Ύ Smart Session Handling: Auto-login and duplicate prevention ensures a smooth user journey.

πŸ“‚ Project Structure

  • frontend/: Contains the visual interface, assets, and client-side logic.
  • backend/: Contains the server logic, scheduler, email services, and database.

⚑ Getting Started

Prerequisites

  • Node.js (v14 or higher)
  • A Gmail account (for sending reminders) with an App Password.

Quick Start

  1. Install Dependencies:

    npm install
    # or entering backend folder manually:
    cd backend && npm install
  2. Configure Environment:

    • Rename backend/.env.example to backend/.env.
    • Add your email credentials:
      EMAIL_USER=your-email@gmail.com
      EMAIL_PASS=your-app-password
  3. Run the App:

    npm start
  4. Open the Browser: Visit http://localhost:3000


πŸ‘₯ Credits

  • Frontend Design & Implementation: [Your Team Name]
  • Backend Architecture & Logic: Senior Developer

About

A smart, automated vaccination tracking system designed to ensure every child gets their vaccines on time.

Resources

Stars

Watchers

Forks