Skip to content

Repository files navigation

🏥 CuraQueue

Smart Clinic Queue Coordinator

A real-time clinic queue management system that seamlessly connects receptionists with patients to eliminate waiting room uncertainty.


✨ Features

Module Description
Reception Panel Keyboard-optimized patient check-in with Alt+N hotkeys, emergency priority toggling, and real-time queue management
Lobby TV Monitor High-contrast billboard display for waiting areas with animated token calls, queue trend graph, and rotating health tips
Waiting Room View Patient-facing search and live timeline board with estimated wait times
Clinical Audit Firestore-backed timestamp analysis — registration vs. consultation durations, searchable historic records
Voice Announcements Web Speech API integration for audible patient token calls on lobby displays

🛠 Tech Stack

  • Frontend: React 19 · TypeScript · Tailwind CSS v4 · Framer Motion
  • Backend: Express.js · WebSocket (real-time sync) · REST fallback
  • Database: Firebase Firestore (persistent audit logs)
  • AI: Gemini API integration for intelligent health tips
  • Build: Vite 6 · esbuild

🏗 Project Structure

├── src/
│   ├── App.tsx                    # Root app with WebSocket + tab routing
│   ├── index.css                  # Theme system + design tokens
│   ├── components/
│   │   ├── LandingPage.tsx        # Marketing-style home page
│   │   ├── ReceptionistPanel.tsx  # Clerk check-in interface
│   │   ├── WaitingRoomPanel.tsx   # Patient-facing queue display
│   │   ├── LobbyTVMode.tsx        # Fullscreen TV billboard
│   │   ├── ClinicalAuditReport.tsx# Firestore audit analytics
│   │   ├── CuraQueueLogo.tsx      # Dynamic SVG brand logo
│   │   └── HealthTipDisplay.tsx   # AI-powered health tip carousel
│   └── services/
│       ├── VoiceAnnouncer.ts      # Web Speech API voice engine
│       └── QueueAnalytics.ts      # Queue trend data collector
├── server.ts                      # Express + WebSocket server
├── firestore.rules                # Firestore security rules
└── index.html                     # Entry point with SEO meta tags

About

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages