VoiceVue AI

AI-powered voice interview platform — practice technical interviews with speech, Gemini-generated questions, and a competitive leaderboard.

Live: voicevue-ai.vercel.app

Features

• Voice interviews via Vapi for real-time speech
• Gemini question generation (@google/generative-ai)
• Auth & data with JWT, MongoDB, and Supabase client utilities
• Practice, library, results, and leaderboard routes
• Modern UI: Next.js App Router, Tailwind, Radix, Framer Motion

App routes

Path	Purpose
/	Landing / home
/practice	Start practice sessions
/interview	Live interview flow
/library	Question / session library
/results	Session results
/leaderboard	Rankings
/auth	Authentication

Stack

• Next.js · React · Tailwind CSS
• Google Gemini · Vapi · OpenAI helpers
• MongoDB · Supabase JS · bcrypt / JWT

Getting started

git clone https://github.com/ANSHSINGH050404/voicevue-ai.git
cd voicevue-ai
npm install

Create a .env (see also GEMINI_INTEGRATION.md and AUTHENTICATION_GUIDE.md):

GOOGLE_API_KEY=...
# plus MongoDB, Vapi, Supabase, and JWT secrets as used in the app

npm run dev
# open http://localhost:3000

Docs in this repo

• AUTHENTICATION_GUIDE.md
• GEMINI_INTEGRATION.md
• CODEBASE_ANALYSIS.md
• TESTING_GUIDE.md

Author

ANSHSINGH050404