Skip to content

Tushargupta9800/hinterview

Repository files navigation

Hinterview

Practice system design interviews with guided questions, AI feedback, a shared diagram playground, and local-first progress tracking.

Support this project: PayPal QR

✨ What It Is

Hinterview is a desktop + web app for practicing:

  • HLD
  • LLD
  • or both on the same problem

It gives you:

  • staged interview questions
  • AI hints and scoring
  • a common canvas/playground
  • learning review
  • custom question generation

🧩 Main Features

Interview Flow

  • Shared question library
  • Search and filters
  • Difficulty sorting
  • Stage locking and ordered progression
  • Retry and redo support
  • Shared stages across HLD and LLD where relevant

AI Support

  • Multiple AI providers
  • Encrypted local API key storage
  • Hint, answer, and evaluation actions
  • Score out of 10.00
  • Pass threshold at 8.00

Playground

  • Text boxes
  • Rectangle, circle, cylinder, diamond
  • Arrows
  • Move, resize, rotate, group select
  • Per-stage containers inside one shared canvas
  • Autosave and restore

Learning

  • Recent attempts
  • Learning themes
  • Recommendations
  • Personal notes

Custom Content

  • Create a full custom question
  • Beautify with AI
  • Add custom stages to existing questions
  • Suggest the next stage with AI

App Experience

  • Dark mode
  • Desktop + web support
  • Local SQLite persistence
  • Migration ledger
  • Error boundary and retry states

🖼️ Screenshots

Product Gallery

Question Library

Question library

My Learnings

Question detail

Question Detail

Playground and evaluation

Shared Question Flow

Shared question flow

Playground

My learning

Learning Themes and Notes

Learning themes and notes

Create a new question

Settings and agent profiles

Custom Question Flow

Custom question flow

LIGHT Mode

Dark mode

Ask AI

Dark mode

🏗️ Workspace

  • apps/renderer → React + Vite UI
  • apps/server → Express + SQLite API
  • apps/desktop → Electron shell
  • packages/shared → shared schemas and seeded questions
  • codex → PRD, milestones, release docs

🚀 Run It

Install:

npm install

Web:

npm run dev:web

Desktop:

npm run dev

Build:

npm run build

Tests:

npm run test

Release checks:

npm run release:check

💾 Persistence

  • SQLite DB: .data/hinterview.sqlite
  • Secret key: .data/secret.key
  • API keys are encrypted at rest
  • Some renderer cache is also kept in local storage

📚 Docs

Contributors