Aced

AI-powered mock interview practice. Paste any job description, choose a question type, and get 5 role-specific interview questions generated by Claude — then submit your answers and receive detailed, scored feedback instantly.

Live demo: aced-dev.vercel.app

---

Features

• Role-specific questions — questions are generated from the actual job description, not generic templates
• Two interview modes — Technical (system design, tradeoffs, language/framework depth) or Behavioral (STAR-format, soft skills)
• AI scoring — each answer is scored 0–10 with specific, actionable feedback
• Instant results — see your average score and per-question breakdown after submission

Tech Stack

Layer	Technology
Frontend	React 19, TypeScript, Tailwind CSS 4
Routing	React Router DOM 7
Backend	Vercel Serverless Functions
AI	Anthropic Claude (claude-haiku-4-5)
Deployment	Vercel

Getting Started

Prerequisites

• Node.js 18+
• An Anthropic API key

Local Development

1. Clone the repo

   git clone https://github.com/your-username/aced.git
   cd aced

2. Install dependencies

   npm install

3. Set up environment variables

   Create a .env file in the project root — this file is git-ignored and must never be committed:

   ANTHROPIC_API_KEY=your_api_key_here

4. Run the dev server

   npm run dev

   The app will be available at http://localhost:5173.

   Note: The /api/* serverless functions require the Vercel CLI to run locally. Install it with npm i -g vercel and use vercel dev instead of npm run dev to test the full stack.

Deployment

This project is configured for Vercel out of the box.

1. Push the repo to GitHub
2. Import it in Vercel
3. Add ANTHROPIC_API_KEY as an environment variable in your Vercel project settings
4. Deploy

The API routes in /api are automatically picked up as Vercel Serverless Functions.

Project Structure

aced/
├── api/
│   ├── generate.ts     # Generates 5 interview questions from a job description
│   └── score.ts        # Scores and provides feedback on submitted answers
├── src/
│   ├── pages/
│   │   ├── Home.tsx        # Landing page — job description input and category selection
│   │   ├── Interview.tsx   # Interview page — renders questions and collects answers
│   │   └── Results.tsx     # Results page — displays scores and feedback
│   ├── components/
│   │   └── Loading.tsx     # Loading animation component
│   ├── types/
│   │   └── index.ts        # Shared TypeScript types
│   ├── App.tsx
│   └── main.tsx

Environment Variables

Variable	Description
ANTHROPIC_API_KEY	Your Anthropic API key — required for question generation and scoring

.env is listed in .gitignore. Never commit this file.