# robiparvez/technical-lead architecture

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

- Interactive diagram: https://gitdiagram.com/robiparvez/technical-lead
- Repository: https://github.com/robiparvez/technical-lead

## Overview

Technical Lead Study Guide is a static interview-preparation app. Readers browse topic-based questions, search or filter the question index, mark questions as known, and view animated diagrams; a separate quiz workflow builds randomized rounds, records answers and scores, and supports review. The graph focuses on these reader-facing flows and their persistence/rendering layers. Some major pages and components were not excerpted, so documented capabilities are represented where supported, while uncertain implementation links are omitted.

Main entry points: [`src/components/Diagram.tsx`](https://github.com/robiparvez/technical-lead/blob/master/src/components/Diagram.tsx) (Diagram player), [`src/data/index.ts`](https://github.com/robiparvez/technical-lead/blob/master/src/data/index.ts) (Topic and search index), [`src/components/QuizRunner.tsx`](https://github.com/robiparvez/technical-lead/blob/master/src/components/QuizRunner.tsx) (Quiz runner), [`src/components/diagrams/shared.tsx`](https://github.com/robiparvez/technical-lead/blob/master/src/components/diagrams/shared.tsx) (Diagram primitives)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_guide["Study guide"]
  node_shell["App shell<br/>[Shell.tsx]"]
  node_topicnav["Topic navigation<br/>[TopicNav.tsx]"]
  node_topicpages["Topic pages<br/>[page.tsx]"]
  node_questionrail["Question rail<br/>[QuestionRail.tsx]"]
  node_home["Study index<br/>[page.tsx]"]
  node_searchbox["Search input<br/>[SearchBox.tsx]"]
  node_searchresults["Search and results<br/>[SearchResults.tsx]"]
  node_references["References<br/>[page.tsx]"]
  node_topics["Topic content"]
  node_dataindex["Topic and search index<br/>[index.ts]"]
end

subgraph group_quiz["Quiz practice"]
  node_quizindexpage["Quiz index page<br/>[page.tsx]"]
  node_quizindex["Quiz listing<br/>[QuizIndex.tsx]"]
  node_quizpage["Quiz attempt page<br/>[page.tsx]"]
  node_quizrunner["Quiz runner<br/>[QuizRunner.tsx]"]
  node_quizlogic["Round and points logic<br/>[quiz.ts]"]
  node_scores["Quiz score state<br/>[scores.ts]"]
  node_points["Points table<br/>[PointsTable.tsx]"]
  node_resultmark["Result mark<br/>[ResultMark.tsx]"]
end

subgraph group_state["Reader state"]
  node_progress["Known-question state<br/>[progress.ts]"]
  node_storage[("Local storage adapter<br/>[storage.ts]")]
  node_themeswitch["Theme switch<br/>[ThemeSwitch.tsx]"]
end

subgraph group_visuals["Diagram rendering"]
  node_diagramhost["Diagram player<br/>[Diagram.tsx]"]
  node_specdiagram["Spec compositions<br/>[SpecDiagram.tsx]"]
  node_handdiagrams["Hand-built diagrams<br/>[StaticDiagrams.tsx]"]
  node_requestflow["Request flow<br/>[RequestFlow.tsx]"]
  node_sagaflow["Saga flow<br/>[SagaFlow.tsx]"]
  node_cicdflow["CI/CD flow<br/>[CiCdFlow.tsx]"]
  node_diagramshared["Diagram primitives<br/>[shared.tsx]"]
end

node_reader(("Reader"))

node_reader -->|"opens app"| node_shell
node_shell -->|"renders"| node_topicnav
node_shell -->|"renders"| node_searchbox
node_reader -->|"opens index"| node_home
node_home -->|"builds index"| node_dataindex
node_home -->|"renders"| node_searchresults
node_searchbox -->|"updates query"| node_searchresults
node_searchresults -->|"filters entries"| node_dataindex
node_searchresults -->|"reads known state"| node_progress
node_topicnav -->|"reads progress"| node_progress
node_reader -->|"opens topic"| node_topicpages
node_topicpages -->|"loads topic"| node_dataindex
node_topicpages -->|"renders questions"| node_questionrail
node_questionrail -->|"toggles known"| node_progress
node_questionrail -->|"renders diagrams"| node_diagramhost
node_reader -->|"opens references"| node_references
node_reader -->|"opens quizzes"| node_quizindexpage
node_quizindexpage -->|"loads topics"| node_dataindex
node_quizindexpage -->|"renders listing"| node_quizindex
node_quizindex -->|"uses quiz rules"| node_quizlogic
node_quizindex -->|"reads scores"| node_scores
node_reader -->|"starts quiz"| node_quizpage
node_quizpage -->|"loads topic"| node_dataindex
node_quizpage -->|"renders attempt"| node_quizrunner
node_quizrunner -->|"builds round"| node_quizlogic
node_quizrunner -->|"records answers"| node_scores
node_quizrunner -->|"renders scoring"| node_points
node_quizrunner -->|"renders result"| node_resultmark
node_progress -->|"persists state"| node_storage
node_scores -->|"persists scores"| node_storage
node_themeswitch -->|"saves preference"| node_storage
node_diagramhost -->|"renders specs"| node_specdiagram
node_diagramhost -->|"selects composition"| node_handdiagrams
node_diagramhost -->|"selects composition"| node_requestflow
node_diagramhost -->|"selects composition"| node_sagaflow
node_diagramhost -->|"selects composition"| node_cicdflow
node_specdiagram -->|"uses primitives"| node_diagramshared
node_handdiagrams -->|"uses primitives"| node_diagramshared
node_requestflow -->|"uses primitives"| node_diagramshared
node_sagaflow -->|"uses primitives"| node_diagramshared
node_cicdflow -->|"uses primitives"| node_diagramshared
node_topics -->|"loaded by"| node_dataindex

click node_shell "https://github.com/robiparvez/technical-lead/blob/master/src/components/Shell.tsx"
click node_topicnav "https://github.com/robiparvez/technical-lead/blob/master/src/components/TopicNav.tsx"
click node_topicpages "https://github.com/robiparvez/technical-lead/blob/master/src/app/topics/%5Bslug%5D/page.tsx"
click node_questionrail "https://github.com/robiparvez/technical-lead/blob/master/src/components/QuestionRail.tsx"
click node_home "https://github.com/robiparvez/technical-lead/blob/master/src/app/page.tsx"
click node_searchbox "https://github.com/robiparvez/technical-lead/blob/master/src/components/SearchBox.tsx"
click node_searchresults "https://github.com/robiparvez/technical-lead/blob/master/src/components/SearchResults.tsx"
click node_references "https://github.com/robiparvez/technical-lead/blob/master/src/app/references/page.tsx"
click node_topics "https://github.com/robiparvez/technical-lead/tree/master/src/data/topics"
click node_dataindex "https://github.com/robiparvez/technical-lead/blob/master/src/data/index.ts"
click node_quizindexpage "https://github.com/robiparvez/technical-lead/blob/master/src/app/quiz/page.tsx"
click node_quizindex "https://github.com/robiparvez/technical-lead/blob/master/src/components/QuizIndex.tsx"
click node_quizpage "https://github.com/robiparvez/technical-lead/blob/master/src/app/quiz/%5Bslug%5D/page.tsx"
click node_quizrunner "https://github.com/robiparvez/technical-lead/blob/master/src/components/QuizRunner.tsx"
click node_quizlogic "https://github.com/robiparvez/technical-lead/blob/master/src/lib/quiz.ts"
click node_scores "https://github.com/robiparvez/technical-lead/blob/master/src/lib/scores.ts"
click node_points "https://github.com/robiparvez/technical-lead/blob/master/src/components/PointsTable.tsx"
click node_resultmark "https://github.com/robiparvez/technical-lead/blob/master/src/components/ResultMark.tsx"
click node_progress "https://github.com/robiparvez/technical-lead/blob/master/src/lib/progress.ts"
click node_storage "https://github.com/robiparvez/technical-lead/blob/master/src/lib/storage.ts"
click node_themeswitch "https://github.com/robiparvez/technical-lead/blob/master/src/components/ThemeSwitch.tsx"
click node_diagramhost "https://github.com/robiparvez/technical-lead/blob/master/src/components/Diagram.tsx"
click node_specdiagram "https://github.com/robiparvez/technical-lead/blob/master/src/components/diagrams/SpecDiagram.tsx"
click node_handdiagrams "https://github.com/robiparvez/technical-lead/blob/master/src/components/diagrams/StaticDiagrams.tsx"
click node_requestflow "https://github.com/robiparvez/technical-lead/blob/master/src/components/diagrams/RequestFlow.tsx"
click node_sagaflow "https://github.com/robiparvez/technical-lead/blob/master/src/components/diagrams/SagaFlow.tsx"
click node_cicdflow "https://github.com/robiparvez/technical-lead/blob/master/src/components/diagrams/CiCdFlow.tsx"
click node_diagramshared "https://github.com/robiparvez/technical-lead/blob/master/src/components/diagrams/shared.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_shell,node_topicnav,node_topicpages,node_questionrail,node_home,node_searchbox,node_searchresults,node_references,node_topics,node_dataindex toneBlue
class node_quizindexpage,node_quizindex,node_quizpage,node_quizrunner,node_quizlogic,node_scores,node_points,node_resultmark toneAmber
class node_progress,node_storage,node_themeswitch toneMint
class node_diagramhost,node_specdiagram,node_handdiagrams,node_requestflow,node_sagaflow,node_cicdflow,node_diagramshared toneRose
class node_reader toneIndigo
```

## Components

### Study guide

- [App shell](https://github.com/robiparvez/technical-lead/blob/master/src/components/Shell.tsx): `src/components/Shell.tsx`
- [Topic navigation](https://github.com/robiparvez/technical-lead/blob/master/src/components/TopicNav.tsx): `src/components/TopicNav.tsx`
- [Topic pages](https://github.com/robiparvez/technical-lead/blob/master/src/app/topics/%5Bslug%5D/page.tsx): `src/app/topics/[slug]/page.tsx`
- [Question rail](https://github.com/robiparvez/technical-lead/blob/master/src/components/QuestionRail.tsx): `src/components/QuestionRail.tsx`
- [Study index](https://github.com/robiparvez/technical-lead/blob/master/src/app/page.tsx): `src/app/page.tsx`
- [Search input](https://github.com/robiparvez/technical-lead/blob/master/src/components/SearchBox.tsx): `src/components/SearchBox.tsx`
- [Search and results](https://github.com/robiparvez/technical-lead/blob/master/src/components/SearchResults.tsx): `src/components/SearchResults.tsx`
- [References](https://github.com/robiparvez/technical-lead/blob/master/src/app/references/page.tsx): `src/app/references/page.tsx`
- [Topic content](https://github.com/robiparvez/technical-lead/tree/master/src/data/topics): `src/data/topics`
- [Topic and search index](https://github.com/robiparvez/technical-lead/blob/master/src/data/index.ts): `src/data/index.ts`

### Quiz practice

- [Quiz index page](https://github.com/robiparvez/technical-lead/blob/master/src/app/quiz/page.tsx): `src/app/quiz/page.tsx`
- [Quiz listing](https://github.com/robiparvez/technical-lead/blob/master/src/components/QuizIndex.tsx): `src/components/QuizIndex.tsx`
- [Quiz attempt page](https://github.com/robiparvez/technical-lead/blob/master/src/app/quiz/%5Bslug%5D/page.tsx): `src/app/quiz/[slug]/page.tsx`
- [Quiz runner](https://github.com/robiparvez/technical-lead/blob/master/src/components/QuizRunner.tsx): `src/components/QuizRunner.tsx`
- [Round and points logic](https://github.com/robiparvez/technical-lead/blob/master/src/lib/quiz.ts): `src/lib/quiz.ts`
- [Quiz score state](https://github.com/robiparvez/technical-lead/blob/master/src/lib/scores.ts): `src/lib/scores.ts`
- [Points table](https://github.com/robiparvez/technical-lead/blob/master/src/components/PointsTable.tsx): `src/components/PointsTable.tsx`
- [Result mark](https://github.com/robiparvez/technical-lead/blob/master/src/components/ResultMark.tsx): `src/components/ResultMark.tsx`

### Reader state

- [Known-question state](https://github.com/robiparvez/technical-lead/blob/master/src/lib/progress.ts): `src/lib/progress.ts`
- [Local storage adapter](https://github.com/robiparvez/technical-lead/blob/master/src/lib/storage.ts): `src/lib/storage.ts`
- [Theme switch](https://github.com/robiparvez/technical-lead/blob/master/src/components/ThemeSwitch.tsx): `src/components/ThemeSwitch.tsx`

### Diagram rendering

- [Diagram player](https://github.com/robiparvez/technical-lead/blob/master/src/components/Diagram.tsx): `src/components/Diagram.tsx`
- [Spec compositions](https://github.com/robiparvez/technical-lead/blob/master/src/components/diagrams/SpecDiagram.tsx): `src/components/diagrams/SpecDiagram.tsx`
- [Hand-built diagrams](https://github.com/robiparvez/technical-lead/blob/master/src/components/diagrams/StaticDiagrams.tsx): `src/components/diagrams/StaticDiagrams.tsx`
- [Request flow](https://github.com/robiparvez/technical-lead/blob/master/src/components/diagrams/RequestFlow.tsx): `src/components/diagrams/RequestFlow.tsx`
- [Saga flow](https://github.com/robiparvez/technical-lead/blob/master/src/components/diagrams/SagaFlow.tsx): `src/components/diagrams/SagaFlow.tsx`
- [CI/CD flow](https://github.com/robiparvez/technical-lead/blob/master/src/components/diagrams/CiCdFlow.tsx): `src/components/diagrams/CiCdFlow.tsx`
- [Diagram primitives](https://github.com/robiparvez/technical-lead/blob/master/src/components/diagrams/shared.tsx): `src/components/diagrams/shared.tsx`

### Other components

- **Reader**

## Connections

- Reader → App shell: opens app
- App shell → Topic navigation: renders (evidence: `src/app/layout.tsx`)
- App shell → Search input: renders (evidence: `src/app/layout.tsx`)
- Reader → Study index: opens index (evidence: `src/app/page.tsx`)
- Study index → Topic and search index: builds index (evidence: `src/app/page.tsx`)
- Study index → Search and results: renders (evidence: `src/app/page.tsx`)
- Search input → Search and results: updates query (evidence: `src/components/SearchBox.tsx`)
- Search and results → Topic and search index: filters entries (evidence: `src/components/SearchResults.tsx`)
- Search and results → Known-question state: reads known state (evidence: `src/components/SearchResults.tsx`)
- Topic navigation → Known-question state: reads progress (evidence: `src/components/TopicNav.tsx`)
- Reader → Topic pages: opens topic (evidence: `src/app/topics/[slug]/page.tsx`)
- Topic pages → Topic and search index: loads topic (evidence: `src/app/topics/[slug]/page.tsx`)
- Topic pages → Question rail: renders questions (evidence: `src/app/topics/[slug]/page.tsx`)
- Question rail → Known-question state: toggles known (evidence: `src/components/QuestionRail.tsx`)
- Question rail → Diagram player: renders diagrams (evidence: `src/components/QuestionRail.tsx`)
- Reader → References: opens references (evidence: `README.md`)
- Reader → Quiz index page: opens quizzes (evidence: `src/app/quiz/page.tsx`)
- Quiz index page → Topic and search index: loads topics (evidence: `src/app/quiz/page.tsx`)
- Quiz index page → Quiz listing: renders listing (evidence: `src/app/quiz/page.tsx`)
- Quiz listing → Round and points logic: uses quiz rules (evidence: `src/components/QuizIndex.tsx`)
- Quiz listing → Quiz score state: reads scores (evidence: `src/components/QuizIndex.tsx`)
- Reader → Quiz attempt page: starts quiz (evidence: `src/app/quiz/[slug]/page.tsx`)
- Quiz attempt page → Topic and search index: loads topic (evidence: `src/app/quiz/[slug]/page.tsx`)
- Quiz attempt page → Quiz runner: renders attempt (evidence: `src/app/quiz/[slug]/page.tsx`)
- Quiz runner → Round and points logic: builds round (evidence: `src/components/QuizRunner.tsx`)
- Quiz runner → Quiz score state: records answers (evidence: `src/components/QuizRunner.tsx`)
- Quiz runner → Points table: renders scoring (evidence: `src/components/QuizRunner.tsx`)
- Quiz runner → Result mark: renders result (evidence: `src/components/QuizRunner.tsx`)
- Known-question state → Local storage adapter: persists state (evidence: `src/lib/progress.ts`)
- Quiz score state → Local storage adapter: persists scores (evidence: `src/lib/scores.ts`)
- Theme switch → Local storage adapter: saves preference (evidence: `src/components/ThemeSwitch.tsx`)
- Diagram player → Spec compositions: renders specs (evidence: `src/components/Diagram.tsx`)
- Diagram player → Hand-built diagrams: selects composition (evidence: `src/components/Diagram.tsx`)
- Diagram player → Request flow: selects composition (evidence: `src/components/Diagram.tsx`)
- Diagram player → Saga flow: selects composition (evidence: `src/components/Diagram.tsx`)
- Diagram player → CI/CD flow: selects composition (evidence: `src/components/Diagram.tsx`)
- Spec compositions → Diagram primitives: uses primitives (evidence: `src/components/diagrams/SpecDiagram.tsx`)
- Hand-built diagrams → Diagram primitives: uses primitives (evidence: `src/components/diagrams/StaticDiagrams.tsx`)
- Request flow → Diagram primitives: uses primitives (evidence: `src/components/diagrams/RequestFlow.tsx`)
- Saga flow → Diagram primitives: uses primitives (evidence: `src/components/diagrams/SagaFlow.tsx`)
- CI/CD flow → Diagram primitives: uses primitives (evidence: `src/components/diagrams/CiCdFlow.tsx`)
- Topic content → Topic and search index: loaded by (evidence: `src/data/index.ts`)
