# s-dileepkumar/atlas architecture

> Architecture diagram of the GitHub repository s-dileepkumar/atlas, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/s-dileepkumar/atlas
- Repository: https://github.com/s-dileepkumar/atlas

## Overview

VLSI Protocol Atlas is an interactive semiconductor engineering learning and exploration platform. An engineer enters through the workspace, selects protocol, IP, SoC, or learning material, then explores specifications, diagrams, simulations, comparisons, and verification guidance. Distinct branches cover protocol reference and validation, silicon IP/SoC exploration, RTL and verification tools, and interactive explainers. The knowledge graph adds cross-domain tracing and repository ingestion. The graph combines documented capabilities with inspected imports; unsampled feature internals are represented at their exact tree paths, without asserting unshown calls.

Main entry points: [`src/App.tsx`](https://github.com/s-dileepkumar/atlas/blob/main/src/App.tsx) (Application router), [`src/data/protocols/index.ts`](https://github.com/s-dileepkumar/atlas/blob/main/src/data/protocols/index.ts) (Protocol catalog), [`src/data/ips/index.ts`](https://github.com/s-dileepkumar/atlas/blob/main/src/data/ips/index.ts) (IP catalog), [`src/components/HomeDashboard.tsx`](https://github.com/s-dileepkumar/atlas/blob/main/src/components/HomeDashboard.tsx) (Home workspace)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workspace["Workspace and navigation"]
  node_app["Application router<br/>[App.tsx]"]
  node_home["Home workspace<br/>[HomeDashboard.tsx]"]
  node_search["Atlas search<br/>[SearchModal.tsx]"]
end

subgraph group_protocol["Protocol engineering"]
  node_protocols[("Protocol catalog<br/>[index.ts]")]
  node_protocoldocs["Protocol specifications"]
  node_diagrams["Protocol diagrams<br/>[DiagramViewers.tsx]"]
  node_waveforms["Waveform studio<br/>[WaveformViewer.tsx]"]
  node_simulator["Cycle simulator<br/>[SimulatorLab.tsx]"]
  node_compliance["Compliance checker"]
  node_comparisons["Protocol comparison"]
end

subgraph group_silicon["Silicon IP and SoC"]
  node_ipcatalog[("IP catalog<br/>[index.ts]")]
  node_ipexplorer["IP explorer"]
  node_ipdetail["IP architecture detail<br/>[IpDetailView.tsx]"]
  node_soc["SoC topologies"]
  node_architecture["Architecture domains"]
end

subgraph group_rtl["RTL and verification"]
  node_rtlstudio["RTL SV UVM handbook"]
  node_rtlsource["RTL source explorer"]
  node_cdc["Clock domain analyzer"]
  node_verification["Verification hub"]
  node_repoingest["RTL repository ingestion"]
  node_parser["RTL parser<br/>[rtlParser.ts]"]
end

subgraph group_learning["Learning and knowledge"]
  node_knowledge["Knowledge graph"]
  node_kgengine["Graph and query engine"]
  node_explainers["Interactive explainers"]
  node_renderers["Visualization renderers"]
  node_depth[("Engineering depth content")]
  node_aes["AES deep dive"]
  node_mindmap["Interactive mind map<br/>[MindMapView.tsx]"]
  node_glossary["Silicon glossary<br/>[GlossaryView.tsx]"]
  node_audit["Completeness audit"]
end

node_engineer(("Engineer"))

node_engineer -->|"opens workspace"| node_app
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_search
node_app -->|"routes to"| node_protocoldocs
node_app -->|"routes to"| node_simulator
node_app -->|"routes to"| node_compliance
node_app -->|"routes to"| node_comparisons
node_app -->|"routes to"| node_ipdetail
node_app -->|"routes to"| node_soc
node_app -->|"routes to"| node_rtlsource
node_app -->|"looks up protocols"| node_protocols
node_protocoldocs -->|"reads catalog"| node_protocols
node_protocoldocs -->|"uses waveforms"| node_waveforms
node_protocoldocs -->|"uses diagrams"| node_diagrams
node_compliance -->|"checks traces"| node_waveforms
node_comparisons -->|"compares entries"| node_protocols
node_home -->|"browses catalog"| node_protocols
node_home -->|"browses IPs"| node_ipcatalog
node_home -->|"opens topologies"| node_soc
node_ipdetail -->|"reads IP data"| node_ipcatalog
node_ipdetail -->|"uses diagrams"| node_diagrams
node_ipdetail -->|"loads explanations"| node_depth
node_architecture -->|"uses catalog"| node_protocols
node_architecture -->|"uses IP data"| node_ipcatalog
node_cdc -->|"analyzes IPs"| node_ipcatalog
node_repoingest -->|"parses RTL"| node_parser
node_knowledge -.->|"queries graph"| node_kgengine
node_kgengine -->|"indexes IPs"| node_ipcatalog
node_kgengine -->|"indexes protocols"| node_protocols
node_kgengine -->|"uses ingestion profile"| node_parser
node_explainers -->|"selects renderers"| node_renderers
node_explainers -.->|"presents depth layers"| node_depth
node_glossary -->|"shows depth content"| node_depth

click node_app "https://github.com/s-dileepkumar/atlas/blob/main/src/App.tsx"
click node_home "https://github.com/s-dileepkumar/atlas/blob/main/src/components/HomeDashboard.tsx"
click node_search "https://github.com/s-dileepkumar/atlas/blob/main/src/components/SearchModal.tsx"
click node_protocols "https://github.com/s-dileepkumar/atlas/blob/main/src/data/protocols/index.ts"
click node_protocoldocs "https://github.com/s-dileepkumar/atlas/blob/main/src/components/ProtocolDocView.tsx"
click node_diagrams "https://github.com/s-dileepkumar/atlas/blob/main/src/components/DiagramViewers.tsx"
click node_waveforms "https://github.com/s-dileepkumar/atlas/blob/main/src/components/WaveformViewer.tsx"
click node_simulator "https://github.com/s-dileepkumar/atlas/blob/main/src/components/SimulatorLab.tsx"
click node_compliance "https://github.com/s-dileepkumar/atlas/blob/main/src/components/ComplianceChecker.tsx"
click node_comparisons "https://github.com/s-dileepkumar/atlas/blob/main/src/components/ComparisonEngine.tsx"
click node_ipcatalog "https://github.com/s-dileepkumar/atlas/blob/main/src/data/ips/index.ts"
click node_ipexplorer "https://github.com/s-dileepkumar/atlas/blob/main/src/components/IpUniverseExplorer.tsx"
click node_ipdetail "https://github.com/s-dileepkumar/atlas/blob/main/src/components/IpDetailView.tsx"
click node_soc "https://github.com/s-dileepkumar/atlas/blob/main/src/components/SocExplorerView.tsx"
click node_architecture "https://github.com/s-dileepkumar/atlas/blob/main/src/components/MasterArchitectureView.tsx"
click node_rtlstudio "https://github.com/s-dileepkumar/atlas/blob/main/src/components/RtlSvUvmStudioView.tsx"
click node_rtlsource "https://github.com/s-dileepkumar/atlas/blob/main/src/components/RtlSourceEngineView.tsx"
click node_cdc "https://github.com/s-dileepkumar/atlas/blob/main/src/components/ClockDomainAnalyzerView.tsx"
click node_verification "https://github.com/s-dileepkumar/atlas/blob/main/src/components/VerificationHubView.tsx"
click node_repoingest "https://github.com/s-dileepkumar/atlas/blob/main/src/components/RepoIngestionView.tsx"
click node_parser "https://github.com/s-dileepkumar/atlas/blob/main/src/utils/rtlParser.ts"
click node_knowledge "https://github.com/s-dileepkumar/atlas/blob/main/src/components/KnowledgeGraphView.tsx"
click node_kgengine "https://github.com/s-dileepkumar/atlas/blob/main/src/data/knowledgeGraphEngine.ts"
click node_explainers "https://github.com/s-dileepkumar/atlas/blob/main/src/components/explainer/InteractiveExplainerView.tsx"
click node_renderers "https://github.com/s-dileepkumar/atlas/blob/main/src/components/explainer/renderers/RendererRegistry.tsx"
click node_depth "https://github.com/s-dileepkumar/atlas/blob/main/src/data/conceptDepthEngine.ts"
click node_aes "https://github.com/s-dileepkumar/atlas/blob/main/src/components/AesDeepDiveView.tsx"
click node_mindmap "https://github.com/s-dileepkumar/atlas/blob/main/src/components/MindMapView.tsx"
click node_glossary "https://github.com/s-dileepkumar/atlas/blob/main/src/components/GlossaryView.tsx"
click node_audit "https://github.com/s-dileepkumar/atlas/blob/main/src/components/DocumentationCompletenessDashboard.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_app,node_home,node_search toneBlue
class node_protocols,node_protocoldocs,node_diagrams,node_waveforms,node_simulator,node_compliance,node_comparisons toneAmber
class node_ipcatalog,node_ipexplorer,node_ipdetail,node_soc,node_architecture toneMint
class node_rtlstudio,node_rtlsource,node_cdc,node_verification,node_repoingest,node_parser toneRose
class node_knowledge,node_kgengine,node_explainers,node_renderers,node_depth,node_aes,node_mindmap,node_glossary,node_audit,node_engineer toneIndigo
```

## Components

### Workspace and navigation

- [Application router](https://github.com/s-dileepkumar/atlas/blob/main/src/App.tsx): `src/App.tsx`
- [Home workspace](https://github.com/s-dileepkumar/atlas/blob/main/src/components/HomeDashboard.tsx): `src/components/HomeDashboard.tsx`
- [Atlas search](https://github.com/s-dileepkumar/atlas/blob/main/src/components/SearchModal.tsx): `src/components/SearchModal.tsx`

### Protocol engineering

- [Protocol catalog](https://github.com/s-dileepkumar/atlas/blob/main/src/data/protocols/index.ts): `src/data/protocols/index.ts`
- [Protocol specifications](https://github.com/s-dileepkumar/atlas/blob/main/src/components/ProtocolDocView.tsx): `src/components/ProtocolDocView.tsx`
- [Protocol diagrams](https://github.com/s-dileepkumar/atlas/blob/main/src/components/DiagramViewers.tsx): `src/components/DiagramViewers.tsx`
- [Waveform studio](https://github.com/s-dileepkumar/atlas/blob/main/src/components/WaveformViewer.tsx): `src/components/WaveformViewer.tsx`
- [Cycle simulator](https://github.com/s-dileepkumar/atlas/blob/main/src/components/SimulatorLab.tsx): `src/components/SimulatorLab.tsx`
- [Compliance checker](https://github.com/s-dileepkumar/atlas/blob/main/src/components/ComplianceChecker.tsx): `src/components/ComplianceChecker.tsx`
- [Protocol comparison](https://github.com/s-dileepkumar/atlas/blob/main/src/components/ComparisonEngine.tsx): `src/components/ComparisonEngine.tsx`

### Silicon IP and SoC

- [IP catalog](https://github.com/s-dileepkumar/atlas/blob/main/src/data/ips/index.ts): `src/data/ips/index.ts`
- [IP explorer](https://github.com/s-dileepkumar/atlas/blob/main/src/components/IpUniverseExplorer.tsx): `src/components/IpUniverseExplorer.tsx`
- [IP architecture detail](https://github.com/s-dileepkumar/atlas/blob/main/src/components/IpDetailView.tsx): `src/components/IpDetailView.tsx`
- [SoC topologies](https://github.com/s-dileepkumar/atlas/blob/main/src/components/SocExplorerView.tsx): `src/components/SocExplorerView.tsx`
- [Architecture domains](https://github.com/s-dileepkumar/atlas/blob/main/src/components/MasterArchitectureView.tsx): `src/components/MasterArchitectureView.tsx`

### RTL and verification

- [RTL SV UVM handbook](https://github.com/s-dileepkumar/atlas/blob/main/src/components/RtlSvUvmStudioView.tsx): `src/components/RtlSvUvmStudioView.tsx`
- [RTL source explorer](https://github.com/s-dileepkumar/atlas/blob/main/src/components/RtlSourceEngineView.tsx): `src/components/RtlSourceEngineView.tsx`
- [Clock domain analyzer](https://github.com/s-dileepkumar/atlas/blob/main/src/components/ClockDomainAnalyzerView.tsx): `src/components/ClockDomainAnalyzerView.tsx`
- [Verification hub](https://github.com/s-dileepkumar/atlas/blob/main/src/components/VerificationHubView.tsx): `src/components/VerificationHubView.tsx`
- [RTL repository ingestion](https://github.com/s-dileepkumar/atlas/blob/main/src/components/RepoIngestionView.tsx): `src/components/RepoIngestionView.tsx`
- [RTL parser](https://github.com/s-dileepkumar/atlas/blob/main/src/utils/rtlParser.ts): `src/utils/rtlParser.ts`

### Learning and knowledge

- [Knowledge graph](https://github.com/s-dileepkumar/atlas/blob/main/src/components/KnowledgeGraphView.tsx): `src/components/KnowledgeGraphView.tsx`
- [Graph and query engine](https://github.com/s-dileepkumar/atlas/blob/main/src/data/knowledgeGraphEngine.ts): `src/data/knowledgeGraphEngine.ts`
- [Interactive explainers](https://github.com/s-dileepkumar/atlas/blob/main/src/components/explainer/InteractiveExplainerView.tsx): `src/components/explainer/InteractiveExplainerView.tsx`
- [Visualization renderers](https://github.com/s-dileepkumar/atlas/blob/main/src/components/explainer/renderers/RendererRegistry.tsx): `src/components/explainer/renderers/RendererRegistry.tsx`
- [Engineering depth content](https://github.com/s-dileepkumar/atlas/blob/main/src/data/conceptDepthEngine.ts): `src/data/conceptDepthEngine.ts`
- [AES deep dive](https://github.com/s-dileepkumar/atlas/blob/main/src/components/AesDeepDiveView.tsx): `src/components/AesDeepDiveView.tsx`
- [Interactive mind map](https://github.com/s-dileepkumar/atlas/blob/main/src/components/MindMapView.tsx): `src/components/MindMapView.tsx`
- [Silicon glossary](https://github.com/s-dileepkumar/atlas/blob/main/src/components/GlossaryView.tsx): `src/components/GlossaryView.tsx`
- [Completeness audit](https://github.com/s-dileepkumar/atlas/blob/main/src/components/DocumentationCompletenessDashboard.tsx): `src/components/DocumentationCompletenessDashboard.tsx`

### Other components

- **Engineer**

## Connections

- Engineer → Application router: opens workspace (evidence: `README.md`)
- Application router → Home workspace: routes to (evidence: `src/App.tsx`)
- Application router → Atlas search: routes to (evidence: `src/App.tsx`)
- Application router → Protocol specifications: routes to (evidence: `src/App.tsx`)
- Application router → Cycle simulator: routes to (evidence: `src/App.tsx`)
- Application router → Compliance checker: routes to (evidence: `src/App.tsx`)
- Application router → Protocol comparison: routes to (evidence: `src/App.tsx`)
- Application router → IP architecture detail: routes to (evidence: `src/App.tsx`)
- Application router → SoC topologies: routes to (evidence: `src/App.tsx`)
- Application router → RTL source explorer: routes to (evidence: `src/App.tsx`)
- Application router → Protocol catalog: looks up protocols (evidence: `src/App.tsx`)
- Protocol specifications → Protocol catalog: reads catalog (evidence: `src/components/ProtocolDocView.tsx`)
- Protocol specifications → Waveform studio: uses waveforms (evidence: `src/components/ProtocolDocView.tsx`)
- Protocol specifications → Protocol diagrams: uses diagrams (evidence: `src/components/ProtocolDocView.tsx`)
- Compliance checker → Waveform studio: checks traces (evidence: `src/components/ComplianceChecker.tsx`)
- Protocol comparison → Protocol catalog: compares entries (evidence: `src/components/ComparisonEngine.tsx`)
- Home workspace → Protocol catalog: browses catalog (evidence: `src/components/HomeDashboard.tsx`)
- Home workspace → IP catalog: browses IPs (evidence: `src/components/HomeDashboard.tsx`)
- Home workspace → SoC topologies: opens topologies (evidence: `src/components/HomeDashboard.tsx`)
- IP architecture detail → IP catalog: reads IP data (evidence: `src/components/IpDetailView.tsx`)
- IP architecture detail → Protocol diagrams: uses diagrams (evidence: `src/components/IpDetailView.tsx`)
- IP architecture detail → Engineering depth content: loads explanations (evidence: `src/components/IpDetailView.tsx`)
- Architecture domains → Protocol catalog: uses catalog (evidence: `src/components/MasterArchitectureView.tsx`)
- Architecture domains → IP catalog: uses IP data (evidence: `src/components/MasterArchitectureView.tsx`)
- Clock domain analyzer → IP catalog: analyzes IPs (evidence: `src/components/ClockDomainAnalyzerView.tsx`)
- RTL repository ingestion → RTL parser: parses RTL (evidence: `src/components/RepoIngestionView.tsx`)
- Knowledge graph → Graph and query engine: queries graph
- Graph and query engine → IP catalog: indexes IPs (evidence: `src/data/knowledgeGraphEngine.ts`)
- Graph and query engine → Protocol catalog: indexes protocols (evidence: `src/data/knowledgeGraphEngine.ts`)
- Graph and query engine → RTL parser: uses ingestion profile (evidence: `src/data/knowledgeGraphEngine.ts`)
- Interactive explainers → Visualization renderers: selects renderers (evidence: `src/components/explainer/InteractiveExplainerView.tsx`)
- Interactive explainers → Engineering depth content: presents depth layers
- Silicon glossary → Engineering depth content: shows depth content (evidence: `src/components/GlossaryView.tsx`)
