InterviewReady

A scalable interview preparation platform covering DSA, System Design, and 12 technologies. Read, practice coding (in your language of choice for DSA), take chapter quizzes, ask an AI tutor questions, and do company-specific interview prep — all in one app.

Stack: React + Tailwind (frontend) · Node.js + Express (backend)

---

Screenshots

Dashboard

After signing in, the home hub lists learning paths (JavaScript, DSA, LeetCode, System Design, React, Node.js, and more). Use the sidebar to browse chapters by technology and level, or pick a path card to start.

Code editor (Practice)

Open a chapter → switch to the Practice tab → write code in the Monaco editor → click Run (or press ⌘/Ctrl + Enter). The backend executes JavaScript/TypeScript in a sandbox and shows console output plus pass/fail results.

How to try it locally

1. Start the app (see Quick Start).
2. Create an account (name only; PIN is optional).
3. On the dashboard, click Continue · JavaScript (or pick any path).
4. Open a chapter with exercises (e.g. Variables & Data Types).
5. Go to Practice, edit the starter code, and click Run.

---

Technologies Supported

Category	Technologies
Interview Core	DSA (JS/Python/Java/C++), System Design
Languages	JavaScript, Python
Frontend	React, Angular, HTML, CSS
Backend	Node.js, Express, FastAPI
Full Stack	Next.js
DevOps	CI/CD
AI	Agentic AI

Each technology follows the same chapter-wise flow:

• Read & Learn — intro + cheat sheet per chapter
• Practice — coding exercises with live execution, or Open in StackBlitz to run/edit in a full online IDE
• Quiz — chapter-wise output & MCQ questions
• Interview Prep — 50+ company-tailored interview questions
• Ask AI — a chat tutor to ask follow-up questions any time

---

Quick Start

# Terminal 1 — Backend
cd interview-ready/backend && npm install && npm run dev

# Terminal 2 — Frontend
cd interview-ready/frontend && npm install && npm run dev

Open http://localhost:5173

Enabling the "Ask AI" tab (optional)

The Ask AI tab needs an LLM API key to return real answers:

cd interview-ready/backend
cp .env.example .env
# then edit .env and set AI_API_KEY=<your key>
npm run dev

Works with OpenAI by default; set AI_API_BASE to point at any OpenAI-compatible provider (Groq, OpenRouter, Azure OpenAI, etc.). Without a key, the tab still works but shows setup instructions instead of live answers.

---

API Structure (scalable per technology)

GET  /api/technologies
GET  /api/:tech/lessons?level=beginner
GET  /api/:tech/lessons/:id
GET  /api/:tech/lessons/:lessonId/exercises/:exerciseId?lang=python   # DSA multi-language
GET  /api/:tech/languages
GET  /api/:tech/quizzes/:lessonId
POST /api/:tech/quizzes/:lessonId/check
POST /api/:tech/interview/generate   { companyName: "Google" }
POST /api/:tech/interview/check
POST /api/execute
POST /api/ai/ask   { question, tech, history }

Examples:

• /api/javascript/lessons
• /api/react/interview/generate
• /api/cicd/interview/generate

---

Adding a New Technology

1. Create backend/data/content/your-tech/index.js exporting:
   • lessons, quizzes, interviewQuestions, INTERVIEW_TOPICS
2. Register in backend/data/contentRegistry.js
3. Add entry to backend/data/technologies.js
4. Add a color in frontend/src/components/Sidebar.jsx if you want a custom accent

---

Project Structure

backend/data/
  technologies.js          # Tech metadata
  contentRegistry.js       # Loads all tech content
  content/
    javascript/              # Full JS content (17 chapters, 72 interview Qs)
    react/                   # 6 chapters, 60 interview Qs
    angular/                 # 6 chapters, 52 interview Qs
    html/ css/ nodejs/ ...   # Same pattern

---

Features

• Folder-tree sidebar navigation (category → technology → level → chapter), like an IDE explorer
• Light / Dark theme toggle
• Per-technology progress tracking (localStorage)
• DSA exercises in JavaScript, Python, Java, or C++
• Open in StackBlitz — run/edit any practice exercise in a full online IDE
• Ask AI tab — chat with an AI tutor about anything you're studying
• Company-based interview question selection (Google, Amazon, TCS, etc.)
• Output-based & MCQ questions
• Topic breakdown after interview