Egzamify

AI-powered learning platform for Polish vocational exams ("egzaminy zawodowe").

Features

• Theory Exams → 40 random questions, 2 min each, instant results
• Practical Exams → AI grading of submitted work
• Online Quiz → 1v1 battles with friends
• AI Chat → Explain any exam topic (ELI5 / Normal / Detailed modes)

Tech Stack

Next.js 15 · React 19 · TypeScript · Convex · Tailwind CSS 4 · AI SDK (Gemini/Groq) · Stripe

Local Setup

# install deps
pnpm install

# start Convex backend → grab URLs from output
npx convex dev

# create .env.local → paste Convex URLs + required keys:
# GROQ_API_KEY, STRIPE_SECRET_KEY, NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY, etc.

# seed database (optional)
pnpm seed

# start dev server
pnpm dev

App → http://localhost:3000

Scripts

Cmd	desc
pnpm dev	start Next.js
pnpm build	production build
pnpm check	lint + typecheck
pnpm seed	seed DB
pnpm format:write	format code

Credits

Exam explanation → 0.5 credits Practical (basic) → 30 credits Practical (complete) → 90 credits AI chat msg → 3 credits