How nilotpal-lab/quizflow-nil-private works
The repository contains two product areas: QuizFlow, a live multiplayer quiz application, and a TaskFlow productivity app. QuizFlow’s principal workflow is quiz preparation and ingestion, hosting a PIN-based session, player participation, and results/history; its stores provide session state, persistence, and account/community features. TaskFlow manages tasks and related productivity data through client stores and an API client. The README identifies QuizFlow as the live multiplayer engine, but sampled evidence does not establish the full server or deployment topology; edges below are limited to documented or indexed references.
Main entry points: studio/page.tsx Quiz studio · sessionStore.ts Session state · supabaseClient.ts Supabase adapter · play/page.tsx Play quiz
Components 27
QuizFlow gameplay
- Host session
src/app/quizflow/host/page.tsx - Play quiz
src/app/quizflow/play/page.tsx - Live leaderboard
src/quizflow/RealtimeLeaderboardModal.tsx - Answer safeguards
src/quizflow/antiCheat.ts - Gameplay effects
src/quizflow/ParticleField.tsx - Sound and speech
src/quizflow/sound.ts
QuizFlow content and data
- Session state
src/quizflow/sessionStore.ts - Quiz studio
src/app/quizflow/studio/page.tsx - Content ingestion
src/quizflow/ingestion.ts - URL ingestion API
src/app/api/ingest-url/route.ts - Spreadsheet parser
src/quizflow/excelQuizParser.ts - Quiz generation API
src/app/api/generate-quiz/route.ts - Tournament rules API
src/app/api/quizflow/parse-tournament-rules/route.ts - Saved quizzes
src/quizflow/quizStore.ts - Quiz history
src/quizflow/historyStore.ts - Quiz community
src/quizflow/communityStore.ts - Community API
src/app/api/community/route.ts - Host accounts
src/quizflow/authStore.ts - Supabase adapter
src/quizflow/supabaseClient.ts
TaskFlow productivity
- Task state
src/store/useTaskStore.ts - Task API client
src/lib/api.ts - Task API service
- Task authentication
src/store/useAuthStore.ts - Productivity views
src/components/views/CalendarView.tsx - Task command modal
src/components/modals/OmniModal.tsx - Task text parser
src/hooks/useTaskParser.ts
Other components
- Task user
Connections 28
- Host session → Session state: manages session
src/app/quizflow/host/page.tsx - Play quiz → Session state: reads and updates
src/app/quizflow/play/page.tsx - Play quiz → Answer safeguards: uses safeguards
src/app/quizflow/play/page.tsx - Play quiz → Gameplay effects: renders effects
src/app/quizflow/play/page.tsx - Play quiz → Sound and speech: plays sounds
src/app/quizflow/play/page.tsx - Host session → Live leaderboard: renders leaderboard
src/app/quizflow/host/page.tsx - Live leaderboard → Session state: reads session
src/quizflow/RealtimeLeaderboardModal.tsx - Quiz studio → Content ingestion: uses ingestion
src/app/quizflow/studio/page.tsx - Content ingestion → URL ingestion API: posts URL
src/quizflow/ingestion.ts - Quiz studio → Spreadsheet parser: uses parser
src/app/quizflow/studio/page.tsx - Session state → Spreadsheet parser: repairs questions
src/quizflow/sessionStore.ts - Quiz studio → Saved quizzes: uses quiz store
src/app/quizflow/studio/page.tsx - Quiz studio → Quiz generation API: generates quizzes
- Quiz studio → Tournament rules API: parses tournament rules
- Session state → Supabase adapter: uses adapter
src/quizflow/sessionStore.ts - Host accounts → Supabase adapter: syncs host accounts
src/quizflow/authStore.ts - Saved quizzes → Supabase adapter: persists quizzes
src/quizflow/quizStore.ts - Quiz history → Supabase adapter: persists history
src/quizflow/historyStore.ts - Quiz community → Supabase adapter: uses adapter
src/quizflow/communityStore.ts - Quiz community → Community API: uses API
- Task user → Task state: manages tasks
- Task state → Task API client: fetches and mutates
src/store/useTaskStore.ts - Task API client → Task API service: sends requests
src/lib/api.ts - Task user → Task authentication: authenticates
- Task authentication → Task API client: calls API
src/store/useAuthStore.ts - Productivity views → Task state: reads task state
src/components/views/CalendarView.tsx - Task command modal → Task state: updates tasks
src/components/modals/OmniModal.tsx - Task command modal → Task text parser: parses input
src/components/modals/OmniModal.tsx