• Dynamic UI: interactive interface with fluid animations.
• On-Screen Numpad: Tailored virtual numeric keypad for age and mobile number entry.
• Admin Dashboard: View and manage the patient queue in real-time.
• Token System: Generates and tracks unique token numbers for patients.

• Frontend: React, Vite, Custom Vanilla CSS
• Backend: Python, FastAPI
• Database: SQLite (local kioskdb.db)

The easiest way to run the entire application is via Docker Compose.

# Start the application
docker-compose up --build

# Run in background
docker-compose up -d

Once the containers are running:

• Frontend: http://localhost:80
• Backend API: http://localhost:8000/docs (Swagger UI)

If you prefer to run the applications locally without Docker:

cd backend
python -m venv venv
source venv/bin/activate  # Or `venv\Scripts\activate` on Windows
pip install -r requirements.txt
uvicorn main:app --reload --port 8000

cd frontend
npm install
npm run dev