Skip to content

rajanarahul93/medicine-scheduler

Repository files navigation

💊 Medicine Scheduler PWA

Never miss your medication again with smart reminders and tracking

PWA React TypeScript Vite

A comprehensive Progressive Web App for medication management with smart scheduling, reminders, and analytics


Features

Core Functionality

  • Smart Medicine Management - Add medicines with custom dosages, frequencies, and schedules
  • Daily Schedule View - Real-time dose tracking with color-coded status indicators
  • Weekly Calendar - 7-day visual schedule with completion percentages
  • Analytics Dashboard - 30-day adherence rates, streak tracking, and performance insights
  • Data Persistence - Reliable IndexedDB storage that survives browser restarts

Progressive Web App

  • ** Fully Installable** - Add to home screen on mobile and desktop
  • Offline Capable - Service Worker caching for complete offline functionality
  • Push Notifications - Scheduled medicine reminders at exact dosage times
  • Cross-Platform - Works seamlessly on iOS, Android, Windows, macOS

User Experience

  • Dark/Light Mode - Theme toggle with system preference detection
  • Smooth Animations - Framer Motion page transitions and micro-interactions
  • Responsive Design - Mobile-first with tablet and desktop optimization
  • Interactive Feedback - Ripple effects, pill animations, and status transitions

Tech Stack

Frontend

  • React 18 - Modern React with hooks and concurrent features
  • TypeScript - Full type safety and development experience
  • Vite - Lightning-fast build tool and dev server
  • Tailwind CSS - Utility-first CSS framework
  • Shadcn UI - Beautiful and accessible React components

PWA & Performance

Animations & Interactions


Quick Start

Prerequisites

  • Node.js 18.x or higher
  • npm 9.x or higher

Installation

  1. Clone the repository
git clone https://github.com/rajanarahul93/medicine-scheduler.git
cd medicine-scheduler
  1. Install dependencies
npm install
  1. Start development server
npm run dev
  1. Open your browser
http://localhost:5173

Build for Production

# Build the app
npm run build

# Preview the production build
npm run preview

Usage Guide

Adding Your First Medicine

  1. Click the "Add" tab in the navigation
  2. Fill in medicine details:
    • Name: e.g., "Vitamin D"
    • Dosage: e.g., "1000 IU"
    • Frequency: Daily, Twice Daily, etc.
    • Times: Select specific reminder times
  3. Click "Add Medicine" to save

Managing Your Schedule

  • Today Tab: View and manage today's doses
  • Weekly Tab: See your medication schedule across 7 days
  • Analytics Tab: Track adherence rates and streaks

Setting Up Notifications

  1. Click "Enable Notifications" when prompted
  2. Allow browser notification permissions
  3. Receive automatic reminders at scheduled times

Customizing Your Experience

  • Theme: Toggle between light and dark mode using the moon/sun icon
  • Colors: Each medicine gets a unique color for easy identification
  • Status: Mark doses as taken, skipped, or missed

PWA Installation

Mobile (iOS/Android)

  1. Open the app in your browser
  2. Look for "Add to Home Screen" prompt
  3. Follow the installation steps
  4. Launch from your home screen like a native app

Desktop (Chrome/Edge)

  1. Look for the install icon in the address bar
  2. Click to install the PWA
  3. Access from your desktop/taskbar

Contributing

We welcome contributions from the community! Here's how you can help:

Getting Started

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

⭐ Star this repo if you found it helpful!

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published