🚀 JobPrep AI

Your AI-Powered Career Companion for Interview Success

🎯 Live Demo • 📚 Documentation • 🐛 Report Bug • 💡 Request Feature

✨ Land Your Dream Job with AI-Powered Interview Preparation

JobPrep is a comprehensive, next-generation platform that combines cutting-edge AI technology with practical career tools to help you ace interviews, build stunning CVs, master coding challenges, and stand out in the competitive job market.

🎯 Key Highlights

🤖 Multi-AI Intelligence - Powered by Google Gemini, OpenAI GPT-4, Claude & Ollama
🎥 Real-Time Video Interviews - LiveKit-powered immersive practice with AI feedback
📄 Professional CV Builder - ATS-friendly templates with LinkedIn import
💻 Code Challenge Arena - Practice coding in 15+ languages with instant feedback
✍️ AI Cover Letters - Generate tailored cover letters in seconds
🎤 Voice & Emotion Analysis - MediaPipe-powered body language insights
📊 Smart Analytics - Track progress, identify weak areas, improve systematically
🔐 Secure & Modern - Passkey authentication, 2FA, enterprise-grade security

🏗️ Architecture

┌─────────────────────────────────────────────────────────────────┐
│                         Frontend Layer                          │
│  Next.js 15 • React 19 • TypeScript • Tailwind CSS • shadcn/ui │
└────────────────────────┬────────────────────────────────────────┘
                         │
┌────────────────────────┴────────────────────────────────────────┐
│                      API Routes Layer                           │
│     /api/ai • /api/interviews • /api/cv • /api/challenges      │
└────────────────────────┬────────────────────────────────────────┘
                         │
┌────────────────────────┴────────────────────────────────────────┐
│                    AI Services Layer                            │
│   Gemini • OpenAI • Claude • Ollama • HeyGen • MediaPipe       │
└────────────────────────┬────────────────────────────────────────┘
                         │
┌────────────────────────┴────────────────────────────────────────┐
│                   Real-time Services                            │
│        LiveKit (Video) • Liveblocks • Socket.io                │
└────────────────────────┬────────────────────────────────────────┘
                         │
┌────────────────────────┴────────────────────────────────────────┐
│                    Data & Storage Layer                         │
│   PostgreSQL (Prisma) • Appwrite • Cloudinary • Stripe         │
└─────────────────────────────────────────────────────────────────┘

🌟 Features

🎤 AI Mock Interviews

Feature	Description
Multi-AI Support	Choose between Gemini, GPT-4, Claude, or local Ollama
Real-time Video	LiveKit-powered HD video/audio with screen sharing
Smart Questions	AI generates role-specific technical & behavioral questions
Instant Feedback	Get detailed analysis of answers, tone, and body language
Voice Analysis	Speech-to-text transcription with emotion detection
Recording	Save interviews for review and improvement tracking
Scheduling	Google Calendar integration for practice sessions

📄 CV Builder

Feature	Description
3 Templates	Professional, modern, and creative ATS-optimized designs
LinkedIn Import	Chrome extension auto-fills CV from LinkedIn profile
Smart Suggestions	AI-powered improvements for bullet points and keywords
Multi-format Export	PDF, DOCX, JSON with customizable styling
Version Control	Save multiple versions, track changes over time
Real-time Preview	Live updates as you type with mobile-responsive view

💻 Code Challenges

Feature	Description
15+ Languages	Java, Python, JavaScript, C++, Go, Rust, and more
Difficulty Levels	Easy, Medium, Hard with curated problem sets
Real-time Execution	Piston API-powered instant code evaluation
Test Cases	Run against multiple test cases with detailed feedback
Leaderboard	Compete with others, track rankings and statistics
Time Tracking	Practice under interview conditions with timers

✍️ Cover Letter Generator

AI-powered cover letter creation tailored to job descriptions using Gemini & GPT-4 with customizable tone and multiple revisions.

🔌 Chrome Extension

One-click LinkedIn CV import - automatically extracts work experience, education, skills, and certifications into JobPrep format.

🛠️ Technology Stack

Frontend

Next.js 15.5 - React framework with App Router & Server Components
React 19.1 - UI library with React Compiler
TypeScript 5 - Type safety
Tailwind CSS 4.0 - Utility-first styling
shadcn/ui - Beautiful accessible components
Framer Motion - Smooth animations

Backend

Node.js 20+ - JavaScript runtime
Prisma 6.17 - Type-safe ORM
PostgreSQL - Primary database
Better Auth 1.3 - Authentication with passkeys & 2FA

AI & ML

Google Gemini - Primary AI for interviews & CV analysis
OpenAI GPT-4 - Advanced reasoning & code evaluation
Anthropic Claude - Alternative AI provider
Ollama - Local AI models (optional)
HeyGen - AI avatar generation
MediaPipe - Body language & emotion analysis

Real-time & Media

LiveKit - WebRTC video/audio conferencing
Socket.io - Real-time notifications
Liveblocks - Collaborative features

Storage & Services

Appwrite - File storage & backend services
Cloudinary - Image optimization & CDN
Stripe - Payment processing & subscriptions

Document Processing

Puppeteer - PDF generation
pdf-lib - PDF manipulation
mammoth - DOCX parsing

Code Execution

Piston API - Multi-language code runner (15+ languages)

🚀 Quick Start

Prerequisites

Node.js 20+
PostgreSQL 14+
npm or pnpm
Git

Installation

# Clone repository
git clone https://github.com/aliammari1/JobPrep.git
cd JobPrep

# Install dependencies
npm install

# Set up environment variables
cp .env.example .env
# Edit .env with your API keys

# Set up database
npx prisma generate
npx prisma db push

# Run development server
npm run dev

Visit http://localhost:3000 🎉

Environment Variables

# Database
DATABASE_URL="postgresql://user:password@localhost:5432/jobprep"

# AI APIs
GOOGLE_GENERATIVE_AI_API_KEY="your_gemini_key"
OPENAI_API_KEY="your_openai_key"
ANTHROPIC_API_KEY="your_claude_key"

# Authentication
BETTER_AUTH_SECRET="your_secret_key"
BETTER_AUTH_URL="http://localhost:3000"

# LiveKit (Video)
LIVEKIT_API_KEY="your_livekit_key"
LIVEKIT_API_SECRET="your_livekit_secret"
LIVEKIT_URL="wss://your-project.livekit.cloud"

# Stripe Payments
STRIPE_SECRET_KEY="your_stripe_secret"
STRIPE_WEBHOOK_SECRET="your_webhook_secret"

# Storage
APPWRITE_ENDPOINT="your_appwrite_endpoint"
APPWRITE_PROJECT_ID="your_project_id"
CLOUDINARY_URL="cloudinary://key:secret@cloud_name"

# Email
SMTP_HOST="smtp.gmail.com"
SMTP_USER="your_email@gmail.com"
SMTP_PASS="your_app_password"

# Google Calendar
GOOGLE_CLIENT_ID="your_google_client_id"
GOOGLE_CLIENT_SECRET="your_google_client_secret"

📁 Project Structure

JobPrep/
├── src/
│   ├── app/                    # Next.js App Router
│   │   ├── (auth)/            # Auth pages (login, register)
│   │   ├── (dashboard)/       # Protected dashboard routes
│   │   ├── api/               # API routes (35+ endpoints)
│   │   │   ├── ai/           # AI chat & processing
│   │   │   ├── interviews/   # Mock interview endpoints
│   │   │   ├── cv/           # CV builder & export
│   │   │   ├── challenges/   # Code challenge submission
│   │   │   ├── livekit/      # Video conferencing
│   │   │   └── stripe/       # Payment webhooks
│   │   └── layout.tsx        # Root layout
│   ├── components/            # React components (150+)
│   │   ├── ui/               # shadcn/ui components
│   │   ├── interviews/       # Interview-related components
│   │   ├── cv/               # CV builder components
│   │   └── challenges/       # Code editor components
│   ├── lib/                  # Utilities & helpers
│   │   ├── prisma.ts        # Database client
│   │   ├── auth.ts          # Auth configuration
│   │   └── ai/              # AI service integrations
│   └── styles/              # Global styles
├── prisma/
│   └── schema.prisma        # Database schema (25+ models)
├── chrome-extension/        # LinkedIn CV importer
│   ├── manifest.json
│   ├── content.js          # LinkedIn scraper
│   └── popup.html          # Extension UI
├── public/                 # Static assets
└── package.json           # Dependencies (80+)

💾 Database Schema

model User {
  id            String          @id @default(cuid())
  email         String          @unique
  name          String?
  image         String?
  interviews    Interview[]
  cvs           CV[]
  submissions   Submission[]
  subscription  Subscription?
  createdAt     DateTime        @default(now())
}

model Interview {
  id            String              @id @default(cuid())
  userId        String
  user          User                @relation(fields: [userId], references: [id])
  jobTitle      String
  jobDescription String
  difficulty    Difficulty
  aiProvider    AIProvider
  questions     Question[]
  responses     InterviewResponse[]
  recordingUrl  String?
  score         Float?
  feedback      String?
  status        InterviewStatus     @default(PENDING)
  scheduledAt   DateTime?
  completedAt   DateTime?
  createdAt     DateTime            @default(now())
}

model CV {
  id            String      @id @default(cuid())
  userId        String
  user          User        @relation(fields: [userId], references: [id])
  template      String
  personalInfo  Json
  experience    Json[]
  education     Json[]
  skills        Json[]
  certifications Json[]
  createdAt     DateTime    @default(now())
  updatedAt     DateTime    @updatedAt
}

model Challenge {
  id            String       @id @default(cuid())
  title         String
  description   String
  difficulty    Difficulty
  language      String
  testCases     Json[]
  submissions   Submission[]
  tags          String[]
  createdAt     DateTime     @default(now())
}

model Subscription {
  id            String   @id @default(cuid())
  userId        String   @unique
  user          User     @relation(fields: [userId], references: [id])
  plan          Plan
  status        String
  stripeId      String   @unique
  currentPeriodEnd DateTime
}

🎨 Screenshots

🏠 Dashboard

🎤 AI Mock Interview

📄 CV Builder

💻 Code Challenges

🔐 Security

🔒 Modern Authentication - Better Auth with passkeys & 2FA
🛡️ HTTPS Only - Automatic SSL via Vercel
🔑 API Key Encryption - AES-256 encrypted storage
🚫 Rate Limiting - DDoS & brute force protection
✅ SQL Injection Safe - Prisma parameterized queries
🧹 XSS Protection - React automatic HTML sanitization
🎫 CSRF Tokens - Built-in cross-site attack prevention
📋 Security Headers - CSP, HSTS, X-Frame-Options

🗺️ Roadmap

✅ Completed (v1.0)

AI-powered mock interviews with multi-provider support
Professional CV builder with 3 templates
Code challenge arena (15+ languages)
Chrome extension for LinkedIn import
Real-time video interviews (LiveKit)
Stripe payment integration
Dashboard & analytics

🚧 In Progress (v1.1 - Q1 2026)

🎓 AI interview coaching with personalized tips
📊 Advanced analytics & skill gap analysis
🎮 Gamification & achievement system
🌍 Multi-language support (i18n)
📱 Mobile responsive improvements

🔮 Planned (v2.0 - Q2 2026)

🥽 VR Interview simulation
📱 iOS & Android mobile apps
👥 Peer interview matching
🎓 Interview coaching marketplace
🧠 Emotion detection & personality analysis
🏢 Company-specific prep (FAANG, startups)
🤝 ATS integration & job application tracking

🤝 Contributing

Contributions are welcome! See our Contributing Guide for details.

# Fork & clone
git clone https://github.com/YOUR_USERNAME/JobPrep.git

# Create branch
git checkout -b feature/amazing-feature

# Commit changes
git commit -m 'feat: add amazing feature'

# Push & create PR
git push origin feature/amazing-feature

Commit Convention

feat: New feature
fix: Bug fix
docs: Documentation
refactor: Code refactoring
test: Adding tests
chore: Maintenance

📄 License

MIT License - see LICENSE for details.

👨‍💻 Author

Ali Ammari

Full-Stack Developer | AI Enthusiast | Open Source Contributor

🙏 Acknowledgments

Special thanks to:

Next.js - The React Framework
Vercel - Deployment & Hosting
Prisma - Next-gen ORM
shadcn/ui - Beautiful Components
LiveKit - Real-time Video
Better Auth - Modern Auth
Google AI - Gemini API
OpenAI - GPT Models
Stripe - Payments

⭐ Support

If you find JobPrep helpful:

⭐ Star the repository
🐦 Share on social media
☕ Buy me a coffee

📈 Star History

Built with ❤️ by Ali Ammari

Helping job seekers land their dream jobs, one interview at a time 🚀

Name		Name	Last commit message	Last commit date
Latest commit History 62 Commits
chrome-extension		chrome-extension
functions/LiveKit Avatar Agent		functions/LiveKit Avatar Agent
prisma		prisma
public		public
src		src
.env.example		.env.example
.gitignore		.gitignore
README.md		README.md
appwrite.config.json		appwrite.config.json
biome.json		biome.json
build.log		build.log
components.json		components.json
next.config.mjs		next.config.mjs
package-lock.json		package-lock.json
package.json		package.json
postcss.config.mjs		postcss.config.mjs
tsconfig.json		tsconfig.json
vercel.json		vercel.json

aliammari1/JobPrep

Folders and files

Latest commit

History

Repository files navigation

🚀 JobPrep AI

Your AI-Powered Career Companion for Interview Success

✨ Land Your Dream Job with AI-Powered Interview Preparation

🎯 Key Highlights

🏗️ Architecture

🌟 Features

🎤 AI Mock Interviews

📄 CV Builder

💻 Code Challenges

✍️ Cover Letter Generator

🔌 Chrome Extension

🛠️ Technology Stack

Frontend

Backend

AI & ML

Real-time & Media

Storage & Services

Document Processing

Code Execution

🚀 Quick Start

Prerequisites

Installation

Environment Variables

📁 Project Structure

💾 Database Schema

🎨 Screenshots

🏠 Dashboard

🎤 AI Mock Interview

📄 CV Builder

💻 Code Challenges

🔐 Security

🗺️ Roadmap

✅ Completed (v1.0)

🚧 In Progress (v1.1 - Q1 2026)

🔮 Planned (v2.0 - Q2 2026)

🤝 Contributing

Commit Convention

📄 License

👨‍💻 Author

Ali Ammari

🙏 Acknowledgments

⭐ Support

📈 Star History

About

Topics

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors 4

Uh oh!

Languages

Packages