An Open-Source Quiz Platform for Interactive Learning - Create engaging quizzes with gamification, real-time features, and zero paywalls.
Live Demo: quest-ed-phi.vercel.app
Security Audit: View Report
Educators shouldn't pay for basic features when they're just trying to make learning engaging. QuestEd combines the best of Kahoot's live interaction with Duolingo's gamification - completely free, forever.
For Teachers
- ✅ Live Quiz Sessions (up to 200 concurrent participants on free tier)
- ✅ Question Bank Management - 500+ pre-loaded questions, CSV/JSON import
- ✅ Classroom Management - Email invitations, join codes, student tracking
- ✅ Multiple Quiz Modes - Live (Kahoot-style) or Deadline (self-paced)
- ✅ Real-time Analytics - Scores, rankings, submission tracking, late penalties
- ✅ Template System - Pre-built quiz templates to get started fast
- ✅ Microsoft Teams Integration - NEW! Import Teams classrooms & students automatically
For Students
- ✅ Daily Challenges - Question of the Day with streaks & countdown timer
- ✅ Quick Quiz - Practice mode with no sign-up required (auto-fill for logged-in users)
- ✅ Student Settings - Comprehensive settings hub with profile, notifications, security & integrations
- ✅ Third-Party Integrations - Microsoft Teams, Google Classroom (coming soon), and more
- ✅ Gamification - Streaks, badges, celebrations, podium animations
- ✅ Progress Tracking - Personal stats, leaderboards, achievement system
- ✅ Mobile-First Design - Works flawlessly on all devices
- ✅ Multi-language Support - Built-in i18n (English, German, more coming)
Real-time Features ⚡
- Live quiz broadcasting with WebSocket (Ably)
- Real-time leaderboard updates
- Connected participants counter
- Auto-advancing questions
- Instant score calculations
- Teacher controls (pause, skip, end)
New Features:
- 🎨 Redesigned Student Dashboard - Space-efficient two-row navbar with better organization
- ⚙️ Student Settings Hub - Comprehensive settings page with 4 tabs:
- Profile management (with enrollment/roll number fields)
- Notification preferences (test assignments, grades, live quiz reminders)
- Security settings (password change, 2FA coming soon)
- Third-party integrations (Microsoft Teams, Google Classroom, and more)
- ⏰ Enhanced Question of the Day - Accurate IST timezone, countdown timer, orange theme consistency
- 🎯 Quick Quiz Auto-fill - Automatically fills your name when logged in
- 🔐 Improved Security -
.gitattributesadded to prevent accidental credential exposure - 📱 Better Mobile Experience - Updated mobile navigation with settings access
Frontend
- Next.js 15 (App Router, React Server Components)
- TypeScript 5.5
- Tailwind CSS + Shadcn UI
- Framer Motion (animations)
- Canvas Confetti (celebrations)
Backend
- Next.js API Routes (serverless)
- Express.js (middleware)
- MongoDB + Mongoose
- JWT Authentication (bcrypt)
- Nodemailer (email system)
- Microsoft Graph API (Teams integration)
Real-time & Infrastructure
- Ably (WebSocket communication)
- Vercel (deployment, CDN, serverless functions)
- MongoDB Atlas (cloud database)
Security 🔒
- Rate limiting (brute-force protection)
- Input sanitization (NoSQL injection prevention)
- Security headers (XSS, clickjacking protection)
- JWT with HTTP-only cookies
- bcrypt password hashing (10 rounds)
- HTTPS enforced in production
- Git security (.gitignore, .gitattributes for sensitive files)
- Credential rotation procedures documented
Ready to get started? Check out our Getting Started Guide for complete setup instructions.
Quick overview:
- Clone the repository
- Install dependencies (
npm install) - Set up environment variables (MongoDB, Ably, JWT)
- Run development server (
npm run dev)
Comprehensive documentation is available in the /docs folder:
- Getting Started - Complete setup walkthrough
- Security Audit Report - Vulnerability analysis & fixes
- Email Setup (5 min) - Configure email invitations
- Azure AD Setup (NEW!) - Visual guide for Microsoft Teams registration
- Microsoft Teams Sync (NEW!) - Import classrooms & students automatically
- Microsoft Teams Integration - Full Teams integration guide
- Student Settings Feature (NEW!) - Comprehensive settings page implementation
- Question of the Day - Daily challenge feature with IST timezone
- i18n Guide - Multiple language support
- Project Summary - Complete architecture overview
We actively welcome contributions! Whether you're fixing bugs, adding features, improving docs, or suggesting ideas - all contributions are valued.
How to Contribute:
- Read CONTRIBUTING.md
- Fork the repository
- Create feature branch (
git checkout -b feature/amazing-feature) - Commit changes (
git commit -m 'Add amazing feature') - Push to branch (
git push origin feature/amazing-feature) - Open Pull Request
Good First Issues:
- 🟢 Add new language translations
- 🟢 Improve mobile responsiveness
- 🟢 Add more quiz templates
- 🟢 Write unit tests
👉 See Full Contribution Guidelines →
This project is licensed under the MIT License - see LICENSE file for details.
TL;DR: You can use, modify, distribute this project for free, even commercially. Just keep the license notice.
If you use QuestEd in your project, please:
- ⭐ Star this repository
- 🔗 Link back to https://github.com/StrungPattern-coder/QuestEd
- 📝 Mention "Built with QuestEd by Sriram Kommalapudi" in your docs
While not legally required, it helps the project grow!
If you find QuestEd useful, here's how you can help:
- ⭐ Star this repository - It helps others discover the project
- 🍴 Fork and contribute - See CONTRIBUTING.md for guidelines
- 📢 Share with educators - Spread the word about free ed-tech tools
- 🐛 Report bugs - Help us improve by opening issues
- 💡 Suggest features - We're always looking for new ideas
- 📝 Write about it - Blog posts, tutorials, or reviews are appreciated
Every contribution, no matter how small, makes a difference! 🙏
For issues or questions:
- GitHub Issues: Report bugs or request features
- Email: connect.help83@gmail.com
- Documentation: Browse all docs
- ✅ Up to 200 concurrent users at the same time (Ably free tier)
- ✅ Unlimited total users
- ✅ Unlimited quizzes and questions
- ✅ All features included (no premium tiers)
- ✅ Open-source (MIT License)
Note: For more than 200 concurrent users, you'll need to upgrade to Ably's paid tier (~$29-299/month depending on scale). See SECURITY_AUDIT_REPORT.md for scaling details.
Built with ❤️ for educators worldwide
Stack: Next.js 15 · TypeScript · MongoDB · Ably · Tailwind CSS · Shadcn UI · Framer Motion