Inspiration

We wanted a way for teachers and trainers to turn their existing materials into engaging, live quizzes in minutes—not hours—and without hitting paywalls or hard limits. Existing tools felt either too locked down, too manual, or too expensive for quick, frequent use.

What it does

Free Kahoot (kahoot.velroi.com) lets hosts upload a PDF or paste a URL, have AI generate a clean, validated quiz, review and edit questions, and then run a live, real-time game that hundreds of players can join via a simple code or link—no login required for players. It manages scoring, leaderboards, and plan-based limits so hosts can reliably run sessions.

How we built it

We built the app with Next.js (App Router) and TypeScript, deployed on Vercel. PostgreSQL with Prisma powers the data layer, and WebSockets (via a hosted real-time provider) handle live game events. Azure OpenAI generates and edits quiz questions from extracted PDF/URL content. Authentication, plan limits, and usage tracking are handled server-side, with a React-based host/player UI on top.

Challenges we ran into

  • Keeping the real-time game experience smooth and consistent with 100–300 concurrent players.
  • Making AI outputs reliable enough for classrooms: validating questions, correct answers, and difficulty levels.
  • Designing a review flow that made it fast to fix AI-generated content instead of fighting it.
  • Enforcing plan limits and usage quotas without breaking the user experience.

Accomplishments that we're proud of

  • A full flow from “raw PDF/URL” → AI-generated quiz → human review → live multiplayer game in one product.
  • Robust game sessions that can survive reconnects and still keep state and scores correct.
  • A clean architecture with well-defined services (auth/plan, quizzes, AI, games) that’s easy to extend.
  • Clear, repeatable deployment docs so anyone can clone, run locally, and deploy to Vercel.

What we learned

  • AI is most useful as a drafting partner, not an oracle—good review tools matter as much as good prompts.
  • Real-time multiplayer at scale forces you to be strict about state machines, timeouts, and backpressure.
  • Educators care a lot about trust: question quality, correctness, and clear controls beat “magic” any day.
  • Investing early in typings, tests, and boundaries made shipping faster, not slower.

What’s next for Free Kahoot | kahoot.velroi.com

  • Richer analytics for hosts (question difficulty, drop-off points, per-session insights).
  • More game modes (teams, lightning rounds, polls) and more question types.
  • Better collaboration: shared quiz libraries, templates, and organization-level workspaces.
  • Deeper integrations (LMS/Google Classroom) and a smoother mobile experience for players.

Built With

  • claude
Share this project:

Updates