# lingarobotics/learning-insights-lgc architecture

> Architecture diagram of the GitHub repository lingarobotics/learning-insights-lgc, 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/lingarobotics/learning-insights-lgc
- Repository: https://github.com/lingarobotics/learning-insights-lgc

## Overview

Learn With Linga is a markdown-driven engineering-insights platform. Readers enter through the home page, browse engineering dimensions, choose a dimension, then fetch and read its insight entries; the serverless API reads markdown files from the public content tree and returns JSON for the React reader. The platform also provides philosophy and reading-guide pages, and supports evidence images embedded in insights. The main API-to-reader flow is visible in the excerpts; content organization and image support are documented in the README.

Main entry points: [`client/src/App.jsx`](https://github.com/lingarobotics/learning-insights-lgc/blob/main/client/src/App.jsx) (Router and splash), [`client/src/pages/InsightsPage.jsx`](https://github.com/lingarobotics/learning-insights-lgc/blob/main/client/src/pages/InsightsPage.jsx) (Insight reader), [`client/src/pages/Home.jsx`](https://github.com/lingarobotics/learning-insights-lgc/blob/main/client/src/pages/Home.jsx) (Home page), [`client/public/insights`](https://github.com/lingarobotics/learning-insights-lgc/tree/main/client/public/insights) (Markdown insight corpus)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Reader experience"]
  node_bootstrap["React bootstrap<br/>[main.jsx]"]
  node_app["Router and splash<br/>[App.jsx]"]
  node_splash["Splash screen<br/>[SplashScreen.jsx]"]
  node_home["Home page<br/>[Home.jsx]"]
  node_dimensions["Dimensions explorer<br/>[DimensionsPage.jsx]"]
  node_dimension["Dimension overview<br/>[DimensionPage.jsx]"]
  node_insights["Insight reader<br/>[InsightsPage.jsx]"]
end

subgraph group_content["Insight content"]
  node_corpus["Markdown insight corpus"]
  node_evidence["Learning evidence images"]
end

subgraph group_backend["Content API"]
  node_api["Dimension API<br/>[&#91;dimension&#93;.js]"]
end

subgraph group_guides["Learning guides"]
  node_philosophy["Platform philosophy<br/>[WhyThisExists.jsx]"]
  node_readingguide["Reading guide"]
end

node_reader(("Reader"))

node_reader -->|"opens platform"| node_bootstrap
node_bootstrap -->|"renders"| node_app
node_app -->|"shows initially"| node_splash
node_app -->|"routes home"| node_home
node_app -->|"routes dimensions"| node_dimensions
node_app -->|"routes dimension"| node_dimension
node_app -->|"routes insights"| node_insights
node_app -->|"routes philosophy"| node_philosophy
node_app -->|"routes guide"| node_readingguide
node_home -->|"navigates to"| node_dimensions
node_home -->|"navigates to"| node_philosophy
node_home -->|"navigates to"| node_readingguide
node_dimensions -->|"opens selection"| node_dimension
node_dimension -->|"opens insights"| node_insights
node_insights -->|"fetches dimension"| node_api
node_api -->|"reads markdown"| node_corpus
node_api -->|"returns JSON"| node_insights
node_corpus -->|"provides entries"| node_insights
node_corpus -.->|"may reference images"| node_evidence

click node_bootstrap "https://github.com/lingarobotics/learning-insights-lgc/blob/main/client/src/main.jsx"
click node_app "https://github.com/lingarobotics/learning-insights-lgc/blob/main/client/src/App.jsx"
click node_splash "https://github.com/lingarobotics/learning-insights-lgc/blob/main/client/src/components/SplashScreen.jsx"
click node_home "https://github.com/lingarobotics/learning-insights-lgc/blob/main/client/src/pages/Home.jsx"
click node_dimensions "https://github.com/lingarobotics/learning-insights-lgc/blob/main/client/src/pages/DimensionsPage.jsx"
click node_dimension "https://github.com/lingarobotics/learning-insights-lgc/blob/main/client/src/pages/DimensionPage.jsx"
click node_insights "https://github.com/lingarobotics/learning-insights-lgc/blob/main/client/src/pages/InsightsPage.jsx"
click node_philosophy "https://github.com/lingarobotics/learning-insights-lgc/blob/main/client/src/pages/WhyThisExists.jsx"
click node_readingguide "https://github.com/lingarobotics/learning-insights-lgc/blob/main/client/src/pages/HowToUseInsights.jsx"
click node_api "https://github.com/lingarobotics/learning-insights-lgc/blob/main/api/insights/%5Bdimension%5D.js"
click node_corpus "https://github.com/lingarobotics/learning-insights-lgc/tree/main/client/public/insights"
click node_evidence "https://github.com/lingarobotics/learning-insights-lgc/tree/main/client/public/images/images-from-learning"

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_bootstrap,node_app,node_splash,node_home,node_dimensions,node_dimension,node_insights toneBlue
class node_corpus,node_evidence toneAmber
class node_api toneMint
class node_philosophy,node_readingguide toneRose
class node_reader toneIndigo
```

## Components

### Reader experience

- [React bootstrap](https://github.com/lingarobotics/learning-insights-lgc/blob/main/client/src/main.jsx): `client/src/main.jsx`
- [Router and splash](https://github.com/lingarobotics/learning-insights-lgc/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Splash screen](https://github.com/lingarobotics/learning-insights-lgc/blob/main/client/src/components/SplashScreen.jsx): `client/src/components/SplashScreen.jsx`
- [Home page](https://github.com/lingarobotics/learning-insights-lgc/blob/main/client/src/pages/Home.jsx): `client/src/pages/Home.jsx`
- [Dimensions explorer](https://github.com/lingarobotics/learning-insights-lgc/blob/main/client/src/pages/DimensionsPage.jsx): `client/src/pages/DimensionsPage.jsx`
- [Dimension overview](https://github.com/lingarobotics/learning-insights-lgc/blob/main/client/src/pages/DimensionPage.jsx): `client/src/pages/DimensionPage.jsx`
- [Insight reader](https://github.com/lingarobotics/learning-insights-lgc/blob/main/client/src/pages/InsightsPage.jsx): `client/src/pages/InsightsPage.jsx`

### Insight content

- [Markdown insight corpus](https://github.com/lingarobotics/learning-insights-lgc/tree/main/client/public/insights): `client/public/insights`
- [Learning evidence images](https://github.com/lingarobotics/learning-insights-lgc/tree/main/client/public/images/images-from-learning): `client/public/images/images-from-learning`

### Content API

- [Dimension API](https://github.com/lingarobotics/learning-insights-lgc/blob/main/api/insights/%5Bdimension%5D.js): `api/insights/[dimension].js`

### Learning guides

- [Platform philosophy](https://github.com/lingarobotics/learning-insights-lgc/blob/main/client/src/pages/WhyThisExists.jsx): `client/src/pages/WhyThisExists.jsx`
- [Reading guide](https://github.com/lingarobotics/learning-insights-lgc/blob/main/client/src/pages/HowToUseInsights.jsx): `client/src/pages/HowToUseInsights.jsx`

### Other components

- **Reader**

## Connections

- Reader → React bootstrap: opens platform (evidence: `README.md`)
- React bootstrap → Router and splash: renders (evidence: `client/src/main.jsx`)
- Router and splash → Splash screen: shows initially (evidence: `client/src/App.jsx`)
- Router and splash → Home page: routes home (evidence: `client/src/App.jsx`)
- Router and splash → Dimensions explorer: routes dimensions (evidence: `client/src/App.jsx`)
- Router and splash → Dimension overview: routes dimension (evidence: `client/src/App.jsx`)
- Router and splash → Insight reader: routes insights (evidence: `client/src/App.jsx`)
- Router and splash → Platform philosophy: routes philosophy (evidence: `client/src/App.jsx`)
- Router and splash → Reading guide: routes guide (evidence: `client/src/App.jsx`)
- Home page → Dimensions explorer: navigates to (evidence: `client/src/pages/Home.jsx`)
- Home page → Platform philosophy: navigates to (evidence: `client/src/pages/Home.jsx`)
- Home page → Reading guide: navigates to (evidence: `client/src/pages/Home.jsx`)
- Dimensions explorer → Dimension overview: opens selection (evidence: `client/src/pages/DimensionsPage.jsx`)
- Dimension overview → Insight reader: opens insights (evidence: `client/src/pages/DimensionPage.jsx`)
- Insight reader → Dimension API: fetches dimension (evidence: `client/src/pages/InsightsPage.jsx`)
- Dimension API → Markdown insight corpus: reads markdown (evidence: `api/insights/[dimension].js`)
- Dimension API → Insight reader: returns JSON (evidence: `README.md`)
- Markdown insight corpus → Insight reader: provides entries (evidence: `README.md`)
- Markdown insight corpus → Learning evidence images: may reference images (evidence: `README.md`)
