Smart, Real-time Queue Management
QueueTrackr is a smart, real-time queue management system built for universities. It allows admin staff to manage queues digitally while students join and track their position seamlessly — eliminating physical waiting lines.
- Create named queues with unique codes (e.g.,
Q3847) - View active queues with real-time updates
- See current user being served
- View list of users in a queue (name and number)
- Dismiss the currently served user to move to the next
- End any active queue
- Fully responsive dashboard for mobile & desktop
- Join a queue using a queue ID
- View position in queue
- See the person currently being served (name & number)
- View all users in queue with names
- Leave a queue at any time
- Real-time updates with Firestore
onSnapshot
Add screenshots of Admin Dashboard and Student View here if needed.
- Frontend: React, CSS
- Authentication: Firebase Auth
- Database: Firebase Firestore
- Hosting: Vite Dev Server (or Firebase Hosting optional)
- Realtime Sync: Firestore
onSnapshot - Image Assets: Custom-designed logos and spinner
# 1. Clone the repository
git clone https://github.com/yourusername/queuetrackr-web.git
# 2. Navigate into the project
cd queuetrackr-web
# 3. Install dependencies
npm install
# 4. Run the development server
npm run dev- Create a project at Firebase Console
- Enable Authentication (Email/Password)
- Set up Firestore database in test mode
- Replace Firebase config values in
/src/firebase.js
const firebaseConfig = {
apiKey: 'YOUR_KEY',
authDomain: 'YOUR_DOMAIN',
projectId: 'YOUR_PROJECT_ID',
...
};src/
├── assets/ # Logo and spinner
├── components/ # Shared UI components like Loader
├── context/ # AuthContext with user state
├── pages/ # Welcome, Login, Signup, Dashboards
├── firebase.js # Firebase config/init
└── App.jsx # Main routing and layout- 🔒 Role-based route protection
- 📱 Push notifications (e.g., “You're next”)
- 📊 Queue analytics dashboard
- 📦 Firebase deployment
Pull requests and suggestions are welcome!
Please open an issue first to discuss your idea or enhancement.
MIT License © 2025 Kamarudeen Abubakar (QueueTrackr)