Kuiz

Modern Web-Based Quiz Platform

Built with React, Vite, TailwindCSS, Supabase, and Netlify

---

Overview

Kuiz is a comprehensive quiz platform that enables administrators to create, manage, and share quizzes while participants can seamlessly join via code or link, attempt quizzes, and view results in real-time.

Key Features

For Administrators

• Quiz Creation - Create MCQs or text-based questions with image support
• AI Integration - Auto-generate questions using Gemini Flash 2.5
• Quiz Management - Add, edit, reorder, or delete questions
• Share Options - Distribute via link, QR code, or WhatsApp
• Result Analytics - View per-user results with detailed responses

For Participants

• Easy Access - Join with 6-character code or shareable link
• Guided Experience - Configurable guidelines and timer controls
• Instant Results - Immediate scoring or delayed email delivery

Core Functionality

• Secure Authentication - Google sign-in via Supabase Auth
• Real-time Participation - Live quiz sessions with timer management
• Flexible Results - Instant display or scheduled email delivery

Tech Stack

Frontend     React + Vite + TypeScript
UI/UX        TailwindCSS + Framer Motion  
Backend      Supabase (Auth & Database)
Deployment   Netlify (Serverless Functions)
AI           Gemini Flash 2.5

Quick Start

Prerequisites

• Node.js (>= 18)
• Supabase project credentials
• Netlify account

Installation

git clone https://github.com/your-username/kuiz.git
cd kuiz
npm install

Environment Setup

Create .env file:

VITE_SUPABASE_URL=your_supabase_url
VITE_SUPABASE_ANON_KEY=your_supabase_anon_key
SUPABASE_SERVICE_ROLE=your_supabase_service_role
GEMINI_API_KEY=your_gemini_api_key

Development

npm run dev

Production Build

npm run build