A real-time, interactive quiz platform for tech events (inspired by Kahoot).

• Features
• Tech Stack
• Project Structure
• Quick Start
• API Endpoints (Backend)
• Frontend Routes
• Scripts
• Environment Variables
• Debugging Tips
• Roadmap
• License
• Owner

• 🎯 Guest Mode: Join quizzes without signing up.
• ⚡ Real-Time Play: Live leaderboard, WebSockets, and dynamic scoring.
• 🤖 AI Question Generation: OpenAI-powered quiz questions.
• 🛠️ Moderator Tools: Create/manage quizzes, export results (CSV/PDF).
• 🎨 Theming: Dark/light mode + custom branding.

devtrivia/
├── backend/           # NestJS backend
│   ├── src/          
│   │   ├── auth/      # JWT authentication  
│   │   ├── quizzes/   # Quiz logic (CRUD, WebSockets)  
│   │   ├── users/     # User management  
│   │   └── main.ts    # App entry point  
│   └── prisma/        # DB schema + migrations  
│
├── frontend/          # Next.js frontend  
│   ├── src/app/       # App Router (Next.js 13+)  
│   ├── components/    # React UI components  
│   └── lib/           # API clients, utilities  
│
├── .env.example       # Environment variables template  
└── README.md          # This file  

git clone https://github.com/icekidtech/devtrivia.git
cd devtrivia
cd backend && pnpm install
cd ../frontend && ppnpm install

1. Install PostgreSQL and create a database named devtrivia.
2. Update backend/.env:

   DATABASE_URL="postgresql://user:password@localhost:5432/devtrivia?schema=public"
   JWT_SECRET="your-jwt-secret-here"
   OPENAI_API_KEY="sk-your-openai-key"  # Optional for AI questions

3. Run migrations:

   cd backend
   npx prisma migrate dev --name init
   npx prisma studio  # Optional: GUI to view DB

• Backend:

  cd backend
  pnpm run start:dev  # http://localhost:3000

• Frontend:

  cd ../frontend
  pnpm run dev        # http://localhost:3001

DATABASE_URL="postgresql://user:password@localhost:5432/devtrivia?schema=public"
JWT_SECRET="change-this-to-a-random-string"
OPENAI_API_KEY="sk-..."  # Only if using AI

NEXT_PUBLIC_BACKEND_URL="http://localhost:3000"
NEXTAUTH_SECRET="same-as-jwt-secret"

• Database Issues: Run npx prisma studio to inspect tables.
• CORS Errors: Ensure backend/src/main.ts allows your frontend origin.
• Socket.IO: Verify the WebSocket path matches in both frontend/backend.

• Implement guest join flow
• Add WebSockets for realtime play
• Integrate OpenAI question generation

MIT

• Udoh Idopise Edwin