# rahulde2007/repo-mind architecture

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

- Interactive diagram: https://gitdiagram.com/rahulde2007/repo-mind
- Repository: https://github.com/rahulde2007/repo-mind

## Overview

RepoMind turns a GitHub repository URL into shared repository context, then offers overview, ingestion, architecture-diagram, and reverse-analysis workflows. The diagram API’s route-to-service and engine calls are visible in source; the other feature branches are retained from the README, but their detailed runtime wiring is not shown in the excerpts. The graph therefore omits uncertain links rather than inferring calls between sibling modules.

Main entry points: [`apps/web/src/app/page.tsx`](https://github.com/rahulde2007/repo-mind/blob/main/apps/web/src/app/page.tsx) (RepoMind workspace), [`apps/web/src/server/repository/index.ts`](https://github.com/rahulde2007/repo-mind/blob/main/apps/web/src/server/repository/index.ts) (Repository service), [`apps/web/src/server/diagram/engine.ts`](https://github.com/rahulde2007/repo-mind/blob/main/apps/web/src/server/diagram/engine.ts) (Diagram engine), [`packages/contracts/src/repository.ts`](https://github.com/rahulde2007/repo-mind/blob/main/packages/contracts/src/repository.ts) (Shared repository context)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workspace["Workspace"]
  node_web_app["RepoMind workspace<br/>[page.tsx]"]
  node_analyzer["Repository analyzer<br/>[page.tsx]"]
  node_overview["Repository overview<br/>[overview-view.tsx]"]
end

subgraph group_repository["Repository context"]
  node_github["GitHub API"]
  node_repo_service["Repository service<br/>[index.ts]"]
  node_url_parser["URL parser<br/>[parser.ts]"]
  node_github_fetch["GitHub tree fetcher<br/>[github.ts]"]
  node_repo_context["Shared repository context<br/>[repository.ts]"]
end

subgraph group_ingest["Ingestion"]
  node_ingest_view["Ingest view<br/>[ingest-view.tsx]"]
  node_ingest_api["Ingest API<br/>[route.ts]"]
  node_ingest_engine["Ingest engine<br/>[engine.ts]"]
  node_ingest_helpers["Selection and formatting"]
end

subgraph group_diagram["Architecture diagrams"]
  node_diagram_view["Diagram view<br/>[diagram-view.tsx]"]
  node_diagram_api["Diagram API<br/>[route.ts]"]
  node_diagram_engine["Diagram engine<br/>[engine.ts]"]
  node_architecture_context["Architecture context<br/>[architecture.ts]"]
  node_mermaid["Mermaid validation<br/>[mermaid.ts]"]
  node_diagram_canvas["Interactive diagram canvas<br/>[diagram-viewer.tsx]"]
end

subgraph group_reverse_ai["Reverse analysis and AI"]
  node_reverse_view["Reverse view<br/>[reverse-view.tsx]"]
  node_reverse_api["Reverse API<br/>[route.ts]"]
  node_reverse_engine["Reverse engine<br/>[engine.ts]"]
  node_reverse_context["Reverse context<br/>[context.ts]"]
  node_ai_gateway["AI provider gateway<br/>[provider.ts]"]
  node_ai_providers["AI provider adapters"]
end

node_developer(("Developer"))

node_developer -->|"uses"| node_web_app
node_web_app -->|"opens analysis"| node_analyzer
node_web_app -->|"shows overview"| node_overview
node_analyzer -.->|"loads repository"| node_repo_service
node_repo_service -->|"parses reference"| node_url_parser
node_repo_service -->|"fetches repository"| node_github_fetch
node_github_fetch -->|"requests tree"| node_github
node_repo_service -->|"creates shared context"| node_repo_context
node_web_app -->|"opens ingest"| node_ingest_view
node_ingest_view -.->|"requests digest"| node_ingest_api
node_ingest_api -.->|"runs ingestion"| node_ingest_engine
node_ingest_engine -->|"filters and formats"| node_ingest_helpers
node_repo_context -->|"supplies context"| node_ingest_engine
node_web_app -->|"opens diagram"| node_diagram_view
node_diagram_view -.->|"requests diagram"| node_diagram_api
node_diagram_api -->|"loads context"| node_repo_service
node_diagram_api -->|"generates diagram"| node_diagram_engine
node_repo_context -->|"supplies context"| node_diagram_engine
node_diagram_engine -->|"extracts structure"| node_architecture_context
node_diagram_engine -->|"requests synthesis"| node_ai_gateway
node_diagram_engine -->|"validates output"| node_mermaid
node_diagram_view -.->|"renders result"| node_diagram_canvas
node_web_app -->|"opens reverse analysis"| node_reverse_view
node_reverse_view -.->|"requests analysis"| node_reverse_api
node_reverse_api -.->|"runs analysis"| node_reverse_engine
node_reverse_engine -->|"builds context"| node_reverse_context
node_repo_context -->|"supplies context"| node_reverse_engine
node_reverse_engine -->|"requests synthesis"| node_ai_gateway
node_ai_gateway -.->|"resolves provider"| node_ai_providers

click node_web_app "https://github.com/rahulde2007/repo-mind/blob/main/apps/web/src/app/page.tsx"
click node_analyzer "https://github.com/rahulde2007/repo-mind/blob/main/apps/web/src/app/analyze/page.tsx"
click node_overview "https://github.com/rahulde2007/repo-mind/blob/main/apps/web/src/components/workspace/overview-view.tsx"
click node_repo_service "https://github.com/rahulde2007/repo-mind/blob/main/apps/web/src/server/repository/index.ts"
click node_url_parser "https://github.com/rahulde2007/repo-mind/blob/main/apps/web/src/server/repository/parser.ts"
click node_github_fetch "https://github.com/rahulde2007/repo-mind/blob/main/apps/web/src/server/repository/github.ts"
click node_repo_context "https://github.com/rahulde2007/repo-mind/blob/main/packages/contracts/src/repository.ts"
click node_ingest_view "https://github.com/rahulde2007/repo-mind/blob/main/apps/web/src/components/workspace/ingest-view.tsx"
click node_ingest_api "https://github.com/rahulde2007/repo-mind/blob/main/apps/web/src/app/api/ingest/route.ts"
click node_ingest_engine "https://github.com/rahulde2007/repo-mind/blob/main/apps/web/src/server/ingest/engine.ts"
click node_ingest_helpers "https://github.com/rahulde2007/repo-mind/tree/main/apps/web/src/server/ingest"
click node_diagram_view "https://github.com/rahulde2007/repo-mind/blob/main/apps/web/src/components/workspace/diagram-view.tsx"
click node_diagram_api "https://github.com/rahulde2007/repo-mind/blob/main/apps/web/src/app/api/diagram/route.ts"
click node_diagram_engine "https://github.com/rahulde2007/repo-mind/blob/main/apps/web/src/server/diagram/engine.ts"
click node_architecture_context "https://github.com/rahulde2007/repo-mind/blob/main/apps/web/src/server/diagram/architecture.ts"
click node_mermaid "https://github.com/rahulde2007/repo-mind/blob/main/apps/web/src/server/diagram/mermaid.ts"
click node_diagram_canvas "https://github.com/rahulde2007/repo-mind/blob/main/apps/web/src/components/diagram/diagram-viewer.tsx"
click node_reverse_view "https://github.com/rahulde2007/repo-mind/blob/main/apps/web/src/components/workspace/reverse-view.tsx"
click node_reverse_api "https://github.com/rahulde2007/repo-mind/blob/main/apps/web/src/app/api/reverse/route.ts"
click node_reverse_engine "https://github.com/rahulde2007/repo-mind/blob/main/apps/web/src/server/reverse/engine.ts"
click node_reverse_context "https://github.com/rahulde2007/repo-mind/blob/main/apps/web/src/server/reverse/context.ts"
click node_ai_gateway "https://github.com/rahulde2007/repo-mind/blob/main/apps/web/src/server/ai/provider.ts"
click node_ai_providers "https://github.com/rahulde2007/repo-mind/tree/main/apps/web/src/server/ai"

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_web_app,node_analyzer,node_overview toneBlue
class node_github,node_repo_service,node_url_parser,node_github_fetch,node_repo_context toneAmber
class node_ingest_view,node_ingest_api,node_ingest_engine,node_ingest_helpers toneMint
class node_diagram_view,node_diagram_api,node_diagram_engine,node_architecture_context,node_mermaid,node_diagram_canvas toneRose
class node_reverse_view,node_reverse_api,node_reverse_engine,node_reverse_context,node_ai_gateway,node_ai_providers,node_developer toneIndigo
```

## Components

### Workspace

- [RepoMind workspace](https://github.com/rahulde2007/repo-mind/blob/main/apps/web/src/app/page.tsx): `apps/web/src/app/page.tsx`
- [Repository analyzer](https://github.com/rahulde2007/repo-mind/blob/main/apps/web/src/app/analyze/page.tsx): `apps/web/src/app/analyze/page.tsx`
- [Repository overview](https://github.com/rahulde2007/repo-mind/blob/main/apps/web/src/components/workspace/overview-view.tsx): `apps/web/src/components/workspace/overview-view.tsx`

### Repository context

- **GitHub API**
- [Repository service](https://github.com/rahulde2007/repo-mind/blob/main/apps/web/src/server/repository/index.ts): `apps/web/src/server/repository/index.ts`
- [URL parser](https://github.com/rahulde2007/repo-mind/blob/main/apps/web/src/server/repository/parser.ts): `apps/web/src/server/repository/parser.ts`
- [GitHub tree fetcher](https://github.com/rahulde2007/repo-mind/blob/main/apps/web/src/server/repository/github.ts): `apps/web/src/server/repository/github.ts`
- [Shared repository context](https://github.com/rahulde2007/repo-mind/blob/main/packages/contracts/src/repository.ts): `packages/contracts/src/repository.ts`

### Ingestion

- [Ingest view](https://github.com/rahulde2007/repo-mind/blob/main/apps/web/src/components/workspace/ingest-view.tsx): `apps/web/src/components/workspace/ingest-view.tsx`
- [Ingest API](https://github.com/rahulde2007/repo-mind/blob/main/apps/web/src/app/api/ingest/route.ts): `apps/web/src/app/api/ingest/route.ts`
- [Ingest engine](https://github.com/rahulde2007/repo-mind/blob/main/apps/web/src/server/ingest/engine.ts): `apps/web/src/server/ingest/engine.ts`
- [Selection and formatting](https://github.com/rahulde2007/repo-mind/tree/main/apps/web/src/server/ingest): `apps/web/src/server/ingest`

### Architecture diagrams

- [Diagram view](https://github.com/rahulde2007/repo-mind/blob/main/apps/web/src/components/workspace/diagram-view.tsx): `apps/web/src/components/workspace/diagram-view.tsx`
- [Diagram API](https://github.com/rahulde2007/repo-mind/blob/main/apps/web/src/app/api/diagram/route.ts): `apps/web/src/app/api/diagram/route.ts`
- [Diagram engine](https://github.com/rahulde2007/repo-mind/blob/main/apps/web/src/server/diagram/engine.ts): `apps/web/src/server/diagram/engine.ts`
- [Architecture context](https://github.com/rahulde2007/repo-mind/blob/main/apps/web/src/server/diagram/architecture.ts): `apps/web/src/server/diagram/architecture.ts`
- [Mermaid validation](https://github.com/rahulde2007/repo-mind/blob/main/apps/web/src/server/diagram/mermaid.ts): `apps/web/src/server/diagram/mermaid.ts`
- [Interactive diagram canvas](https://github.com/rahulde2007/repo-mind/blob/main/apps/web/src/components/diagram/diagram-viewer.tsx): `apps/web/src/components/diagram/diagram-viewer.tsx`

### Reverse analysis and AI

- [Reverse view](https://github.com/rahulde2007/repo-mind/blob/main/apps/web/src/components/workspace/reverse-view.tsx): `apps/web/src/components/workspace/reverse-view.tsx`
- [Reverse API](https://github.com/rahulde2007/repo-mind/blob/main/apps/web/src/app/api/reverse/route.ts): `apps/web/src/app/api/reverse/route.ts`
- [Reverse engine](https://github.com/rahulde2007/repo-mind/blob/main/apps/web/src/server/reverse/engine.ts): `apps/web/src/server/reverse/engine.ts`
- [Reverse context](https://github.com/rahulde2007/repo-mind/blob/main/apps/web/src/server/reverse/context.ts): `apps/web/src/server/reverse/context.ts`
- [AI provider gateway](https://github.com/rahulde2007/repo-mind/blob/main/apps/web/src/server/ai/provider.ts): `apps/web/src/server/ai/provider.ts`
- [AI provider adapters](https://github.com/rahulde2007/repo-mind/tree/main/apps/web/src/server/ai): `apps/web/src/server/ai`

### Other components

- **Developer**

## Connections

- Developer → RepoMind workspace: uses (evidence: `README.md`)
- RepoMind workspace → Repository analyzer: opens analysis (evidence: `README.md`)
- RepoMind workspace → Repository overview: shows overview (evidence: `README.md`)
- Repository analyzer → Repository service: loads repository
- Repository service → URL parser: parses reference (evidence: `apps/web/src/server/repository/index.ts`)
- Repository service → GitHub tree fetcher: fetches repository (evidence: `apps/web/src/server/repository/index.ts`)
- GitHub tree fetcher → GitHub API: requests tree (evidence: `README.md`)
- Repository service → Shared repository context: creates shared context (evidence: `README.md`)
- RepoMind workspace → Ingest view: opens ingest (evidence: `README.md`)
- Ingest view → Ingest API: requests digest
- Ingest API → Ingest engine: runs ingestion
- Ingest engine → Selection and formatting: filters and formats (evidence: `apps/web/src/server/ingest/engine.ts`)
- Shared repository context → Ingest engine: supplies context (evidence: `apps/web/src/server/ingest/engine.ts`)
- RepoMind workspace → Diagram view: opens diagram (evidence: `README.md`)
- Diagram view → Diagram API: requests diagram
- Diagram API → Repository service: loads context (evidence: `apps/web/src/app/api/diagram/route.ts`)
- Diagram API → Diagram engine: generates diagram (evidence: `apps/web/src/app/api/diagram/route.ts`)
- Shared repository context → Diagram engine: supplies context (evidence: `apps/web/src/server/diagram/engine.ts`)
- Diagram engine → Architecture context: extracts structure (evidence: `apps/web/src/server/diagram/engine.ts`)
- Diagram engine → AI provider gateway: requests synthesis (evidence: `apps/web/src/server/diagram/engine.ts`)
- Diagram engine → Mermaid validation: validates output (evidence: `apps/web/src/server/diagram/engine.ts`)
- Diagram view → Interactive diagram canvas: renders result
- RepoMind workspace → Reverse view: opens reverse analysis (evidence: `README.md`)
- Reverse view → Reverse API: requests analysis
- Reverse API → Reverse engine: runs analysis
- Reverse engine → Reverse context: builds context (evidence: `apps/web/src/server/reverse/engine.ts`)
- Shared repository context → Reverse engine: supplies context (evidence: `apps/web/src/server/reverse/engine.ts`)
- Reverse engine → AI provider gateway: requests synthesis (evidence: `apps/web/src/server/reverse/engine.ts`)
- AI provider gateway → AI provider adapters: resolves provider
