# chandru2017/interview-learning architecture

> Architecture diagram of the GitHub repository chandru2017/interview-learning, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/chandru2017/interview-learning
- Repository: https://github.com/chandru2017/interview-learning

## Overview

Frontend Interview Prep is a Next.js interview-practice dashboard. Users browse a topic or search for a question, open its structured answer, navigate between questions, and track completion; the dashboard summarizes topic coverage and progress. The app combines a static question catalog with client-side progress and theme preferences. The graph follows documented routes and features and sampled imports/calls; several UI implementations and the question registry were not excerpted, so their internal connections are omitted where not evidenced.

Main entry points: [`src/lib/data.ts`](https://github.com/chandru2017/interview-learning/blob/dev/src/lib/data.ts) (Catalog and queries), [`src/components/providers/progress-provider.tsx`](https://github.com/chandru2017/interview-learning/blob/dev/src/components/providers/progress-provider.tsx) (Progress state), [`src/components/AppShell.tsx`](https://github.com/chandru2017/interview-learning/blob/dev/src/components/AppShell.tsx) (App shell), [`src/components/QuestionDetail.tsx`](https://github.com/chandru2017/interview-learning/blob/dev/src/components/QuestionDetail.tsx) (Question detail)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_routing["App routes"]
  node_home_route["Dashboard route<br/>[page.tsx]"]
  node_topic_route["Topic route<br/>[page.tsx]"]
  node_detail_route["Question route<br/>[page.tsx]"]
  node_app_shell["App shell<br/>[AppShell.tsx]"]
end

subgraph group_practice["Practice experience"]
  node_dashboard["Dashboard<br/>[HomeDashboard.tsx]"]
  node_question_list["Topic questions<br/>[QuestionList.tsx]"]
  node_question_detail["Question detail<br/>[QuestionDetail.tsx]"]
  node_search["Question search<br/>[SearchBar.tsx]"]
  node_header["Header<br/>[Header.tsx]"]
  node_sidebar["Topic navigation<br/>[Sidebar.tsx]"]
  node_answer_renderer["Answer renderer<br/>[AnswerContent.tsx]"]
  node_inline_markup["Inline markup<br/>[InlineMarkup.tsx]"]
  node_code_formatter["Code formatter<br/>[FormatCode.tsx]"]
end

subgraph group_content["Question content"]
  node_catalog["Catalog and queries<br/>[data.ts]"]
  node_question_bank["Topic question sets"]
  node_question_factory["Question normalizer<br/>[create-question.ts]"]
end

subgraph group_shared["App state"]
  node_progress["Progress state"]
  node_theme["Theme preference<br/>[theme-provider.tsx]"]
  node_local_storage[("Browser localStorage")]
end

node_user(("Learner"))

node_user -->|"opens dashboard"| node_home_route
node_user -->|"browses topic"| node_topic_route
node_user -->|"opens question"| node_detail_route
node_home_route -->|"renders"| node_dashboard
node_topic_route -->|"looks up topic"| node_catalog
node_topic_route -->|"renders"| node_question_list
node_detail_route -->|"looks up question"| node_catalog
node_detail_route -->|"renders"| node_question_detail
node_app_shell -->|"renders"| node_header
node_app_shell -->|"renders"| node_sidebar
node_app_shell -->|"renders"| node_search
node_app_shell -->|"provides state"| node_progress
node_app_shell -->|"provides theme"| node_theme
node_dashboard -->|"reads catalog"| node_catalog
node_dashboard -->|"reads progress"| node_progress
node_question_list -->|"reads questions"| node_catalog
node_question_list -->|"reads and resets"| node_progress
node_question_detail -->|"gets neighbors"| node_catalog
node_question_detail -->|"renders answers"| node_answer_renderer
node_question_detail -->|"updates status"| node_progress
node_search -->|"searches questions"| node_catalog
node_search -->|"enriches results"| node_progress
node_answer_renderer -->|"renders markup"| node_inline_markup
node_answer_renderer -->|"formats code"| node_code_formatter
node_catalog -->|"loads sets"| node_question_bank
node_question_bank -->|"creates entries"| node_question_factory
node_progress -->|"reads questions"| node_catalog
node_progress -->|"persists progress"| node_local_storage
node_theme -->|"persists theme"| node_local_storage

click node_home_route "https://github.com/chandru2017/interview-learning/blob/dev/src/app/page.tsx"
click node_topic_route "https://github.com/chandru2017/interview-learning/blob/dev/src/app/%5Btopic%5D/page.tsx"
click node_detail_route "https://github.com/chandru2017/interview-learning/blob/dev/src/app/%5Btopic%5D/%5BquestionId%5D/page.tsx"
click node_app_shell "https://github.com/chandru2017/interview-learning/blob/dev/src/components/AppShell.tsx"
click node_dashboard "https://github.com/chandru2017/interview-learning/blob/dev/src/components/HomeDashboard.tsx"
click node_question_list "https://github.com/chandru2017/interview-learning/blob/dev/src/components/QuestionList.tsx"
click node_question_detail "https://github.com/chandru2017/interview-learning/blob/dev/src/components/QuestionDetail.tsx"
click node_search "https://github.com/chandru2017/interview-learning/blob/dev/src/components/SearchBar.tsx"
click node_header "https://github.com/chandru2017/interview-learning/blob/dev/src/components/Header.tsx"
click node_sidebar "https://github.com/chandru2017/interview-learning/blob/dev/src/components/Sidebar.tsx"
click node_answer_renderer "https://github.com/chandru2017/interview-learning/blob/dev/src/components/AnswerContent.tsx"
click node_inline_markup "https://github.com/chandru2017/interview-learning/blob/dev/src/components/InlineMarkup.tsx"
click node_code_formatter "https://github.com/chandru2017/interview-learning/blob/dev/src/components/FormatCode.tsx"
click node_catalog "https://github.com/chandru2017/interview-learning/blob/dev/src/lib/data.ts"
click node_question_bank "https://github.com/chandru2017/interview-learning/tree/dev/src/lib/questions"
click node_question_factory "https://github.com/chandru2017/interview-learning/blob/dev/src/lib/questions/create-question.ts"
click node_progress "https://github.com/chandru2017/interview-learning/blob/dev/src/components/providers/progress-provider.tsx"
click node_theme "https://github.com/chandru2017/interview-learning/blob/dev/src/components/providers/theme-provider.tsx"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_home_route,node_topic_route,node_detail_route,node_app_shell toneBlue
class node_dashboard,node_question_list,node_question_detail,node_search,node_header,node_sidebar,node_answer_renderer,node_inline_markup,node_code_formatter toneAmber
class node_catalog,node_question_bank,node_question_factory toneMint
class node_progress,node_theme,node_local_storage toneRose
class node_user toneIndigo
```

## Components

### App routes

- [Dashboard route](https://github.com/chandru2017/interview-learning/blob/dev/src/app/page.tsx): `src/app/page.tsx`
- [Topic route](https://github.com/chandru2017/interview-learning/blob/dev/src/app/%5Btopic%5D/page.tsx): `src/app/[topic]/page.tsx`
- [Question route](https://github.com/chandru2017/interview-learning/blob/dev/src/app/%5Btopic%5D/%5BquestionId%5D/page.tsx): `src/app/[topic]/[questionId]/page.tsx`
- [App shell](https://github.com/chandru2017/interview-learning/blob/dev/src/components/AppShell.tsx): `src/components/AppShell.tsx`

### Practice experience

- [Dashboard](https://github.com/chandru2017/interview-learning/blob/dev/src/components/HomeDashboard.tsx): `src/components/HomeDashboard.tsx`
- [Topic questions](https://github.com/chandru2017/interview-learning/blob/dev/src/components/QuestionList.tsx): `src/components/QuestionList.tsx`
- [Question detail](https://github.com/chandru2017/interview-learning/blob/dev/src/components/QuestionDetail.tsx): `src/components/QuestionDetail.tsx`
- [Question search](https://github.com/chandru2017/interview-learning/blob/dev/src/components/SearchBar.tsx): `src/components/SearchBar.tsx`
- [Header](https://github.com/chandru2017/interview-learning/blob/dev/src/components/Header.tsx): `src/components/Header.tsx`
- [Topic navigation](https://github.com/chandru2017/interview-learning/blob/dev/src/components/Sidebar.tsx): `src/components/Sidebar.tsx`
- [Answer renderer](https://github.com/chandru2017/interview-learning/blob/dev/src/components/AnswerContent.tsx): `src/components/AnswerContent.tsx`
- [Inline markup](https://github.com/chandru2017/interview-learning/blob/dev/src/components/InlineMarkup.tsx): `src/components/InlineMarkup.tsx`
- [Code formatter](https://github.com/chandru2017/interview-learning/blob/dev/src/components/FormatCode.tsx): `src/components/FormatCode.tsx`

### Question content

- [Catalog and queries](https://github.com/chandru2017/interview-learning/blob/dev/src/lib/data.ts): `src/lib/data.ts`
- [Topic question sets](https://github.com/chandru2017/interview-learning/tree/dev/src/lib/questions): `src/lib/questions`
- [Question normalizer](https://github.com/chandru2017/interview-learning/blob/dev/src/lib/questions/create-question.ts): `src/lib/questions/create-question.ts`

### App state

- [Progress state](https://github.com/chandru2017/interview-learning/blob/dev/src/components/providers/progress-provider.tsx): `src/components/providers/progress-provider.tsx`
- [Theme preference](https://github.com/chandru2017/interview-learning/blob/dev/src/components/providers/theme-provider.tsx): `src/components/providers/theme-provider.tsx`
- **Browser localStorage**

### Other components

- **Learner**

## Connections

- Learner → Dashboard route: opens dashboard
- Learner → Topic route: browses topic
- Learner → Question route: opens question
- Dashboard route → Dashboard: renders (evidence: `src/app/page.tsx`)
- Topic route → Catalog and queries: looks up topic (evidence: `src/app/[topic]/page.tsx`)
- Topic route → Topic questions: renders (evidence: `src/app/[topic]/page.tsx`)
- Question route → Catalog and queries: looks up question (evidence: `src/app/[topic]/[questionId]/page.tsx`)
- Question route → Question detail: renders (evidence: `src/app/[topic]/[questionId]/page.tsx`)
- App shell → Header: renders (evidence: `src/components/AppShell.tsx`)
- App shell → Topic navigation: renders (evidence: `src/components/AppShell.tsx`)
- App shell → Question search: renders (evidence: `src/components/AppShell.tsx`)
- App shell → Progress state: provides state (evidence: `src/components/AppShell.tsx`)
- App shell → Theme preference: provides theme (evidence: `src/components/AppShell.tsx`)
- Dashboard → Catalog and queries: reads catalog (evidence: `src/components/HomeDashboard.tsx`)
- Dashboard → Progress state: reads progress (evidence: `src/components/HomeDashboard.tsx`)
- Topic questions → Catalog and queries: reads questions (evidence: `src/components/QuestionList.tsx`)
- Topic questions → Progress state: reads and resets (evidence: `src/components/QuestionList.tsx`)
- Question detail → Catalog and queries: gets neighbors (evidence: `src/components/QuestionDetail.tsx`)
- Question detail → Answer renderer: renders answers (evidence: `src/components/QuestionDetail.tsx`)
- Question detail → Progress state: updates status (evidence: `src/components/QuestionDetail.tsx`)
- Question search → Catalog and queries: searches questions (evidence: `src/components/SearchBar.tsx`)
- Question search → Progress state: enriches results (evidence: `src/components/SearchBar.tsx`)
- Answer renderer → Inline markup: renders markup (evidence: `src/components/AnswerContent.tsx`)
- Answer renderer → Code formatter: formats code (evidence: `src/components/AnswerContent.tsx`)
- Catalog and queries → Topic question sets: loads sets (evidence: `src/lib/data.ts`)
- Topic question sets → Question normalizer: creates entries (evidence: `src/lib/questions/git-cicd/git-questions-set-2.ts`)
- Progress state → Catalog and queries: reads questions (evidence: `src/components/providers/progress-provider.tsx`)
- Progress state → Browser localStorage: persists progress
- Theme preference → Browser localStorage: persists theme
