# lingarobotics/lgc-learnlogic-code architecture

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

## Overview

LGC LearnLogic Code is a frontend learning framework: learners begin with source material, use a structured AI prompt to obtain an explanation, read it critically, identify gaps, and ask focused questions. The React app routes among that core flow, reusable reading guidance, and demonstration content. AI is an external, learner-operated verification aid, not an integrated tutoring service. The source index and excerpts show routing, page navigation, and shared layout; unsampled page implementations are represented by their indexed paths without inferring their internal behavior.

Main entry points: [`frontend/src/App.jsx`](https://github.com/lingarobotics/lgc-learnlogic-code/blob/main/frontend/src/App.jsx) (Route App), [`frontend/src/components/PageWrapper.jsx`](https://github.com/lingarobotics/lgc-learnlogic-code/blob/main/frontend/src/components/PageWrapper.jsx) (Page Wrapper), [`frontend/src/pages/Example.jsx`](https://github.com/lingarobotics/lgc-learnlogic-code/blob/main/frontend/src/pages/Example.jsx) (Example Hub), [`frontend/src/pages/MainAgenda.jsx`](https://github.com/lingarobotics/lgc-learnlogic-code/blob/main/frontend/src/pages/MainAgenda.jsx) (Learning Agenda)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_learning_flow["Core Learning Flow"]
  node_home["Home<br/>[Home.jsx]"]
  node_agenda["Learning Agenda<br/>[MainAgenda.jsx]"]
  node_transcript["Transcript Guidance<br/>[Transcript.jsx]"]
end

subgraph group_ai_guidance["AI Guidance"]
  node_prompt["Prompt Overview<br/>[AIPrompt.jsx]"]
  node_prompt_full["Full AI Prompt<br/>[AIPromptFull.jsx]"]
  node_reading["Reading Guide<br/>[ReadingGuide.jsx]"]
end

subgraph group_examples["Example Materials"]
  node_example_hub["Example Hub<br/>[Example.jsx]"]
  node_flow_guide["Example Flow Guide"]
  node_example_reading["Example Reading Guide"]
  node_example_transcript["Example Transcript Page"]
  node_transcript_sample["Transcript Sample"]
  node_ai_response_page["AI Response Page"]
  node_ai_response_sample["AI Response Sample"]
end

subgraph group_app_shell["App Shell"]
  node_app["Route App<br/>[App.jsx]"]
  node_splash["Splash Screen<br/>[SplashScreen.jsx]"]
  node_wrapper["Page Wrapper<br/>[PageWrapper.jsx]"]
end

node_learner(("Learner"))
node_ai_tool["External AI Tool"]

node_learner -.->|"opens application"| node_app
node_app -->|"renders"| node_splash
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_agenda
node_app -->|"routes to"| node_transcript
node_app -->|"routes to"| node_prompt
node_app -->|"routes to"| node_prompt_full
node_app -->|"routes to"| node_reading
node_app -->|"routes to"| node_example_hub
node_app -->|"routes to"| node_flow_guide
node_app -->|"routes to"| node_example_reading
node_app -->|"routes to"| node_example_transcript
node_app -->|"routes to"| node_ai_response_page
node_home -->|"renders within"| node_wrapper
node_agenda -->|"renders within"| node_wrapper
node_transcript -->|"renders within"| node_wrapper
node_prompt -->|"renders within"| node_wrapper
node_prompt_full -->|"renders within"| node_wrapper
node_reading -->|"renders within"| node_wrapper
node_example_hub -->|"renders within"| node_wrapper
node_flow_guide -->|"renders within"| node_wrapper
node_example_reading -->|"renders within"| node_wrapper
node_example_transcript -->|"renders within"| node_wrapper
node_ai_response_page -->|"renders within"| node_wrapper
node_home -->|"continues to"| node_agenda
node_agenda -->|"continues to"| node_transcript
node_transcript -->|"continues to"| node_prompt
node_reading -->|"applies to example"| node_example_reading
node_example_hub -->|"opens transcript"| node_example_transcript
node_example_hub -->|"opens response"| node_ai_response_page
node_example_transcript -->|"renders sample"| node_transcript_sample
node_ai_response_page -->|"renders sample"| node_ai_response_sample
node_learner -.->|"provides transcript and prompt"| node_ai_tool

click node_app "https://github.com/lingarobotics/lgc-learnlogic-code/blob/main/frontend/src/App.jsx"
click node_splash "https://github.com/lingarobotics/lgc-learnlogic-code/blob/main/frontend/src/components/SplashScreen.jsx"
click node_wrapper "https://github.com/lingarobotics/lgc-learnlogic-code/blob/main/frontend/src/components/PageWrapper.jsx"
click node_home "https://github.com/lingarobotics/lgc-learnlogic-code/blob/main/frontend/src/pages/Home.jsx"
click node_agenda "https://github.com/lingarobotics/lgc-learnlogic-code/blob/main/frontend/src/pages/MainAgenda.jsx"
click node_transcript "https://github.com/lingarobotics/lgc-learnlogic-code/blob/main/frontend/src/pages/Transcript.jsx"
click node_prompt "https://github.com/lingarobotics/lgc-learnlogic-code/blob/main/frontend/src/pages/AIPrompt.jsx"
click node_prompt_full "https://github.com/lingarobotics/lgc-learnlogic-code/blob/main/frontend/src/pages/AIPromptFull.jsx"
click node_reading "https://github.com/lingarobotics/lgc-learnlogic-code/blob/main/frontend/src/pages/ReadingGuide.jsx"
click node_example_hub "https://github.com/lingarobotics/lgc-learnlogic-code/blob/main/frontend/src/pages/Example.jsx"
click node_flow_guide "https://github.com/lingarobotics/lgc-learnlogic-code/blob/main/frontend/src/pages/ExampleFlowGuide.jsx"
click node_example_reading "https://github.com/lingarobotics/lgc-learnlogic-code/blob/main/frontend/src/pages/ExampleReadingGuidePage.jsx"
click node_example_transcript "https://github.com/lingarobotics/lgc-learnlogic-code/blob/main/frontend/src/pages/ExampleTranscriptPage.jsx"
click node_transcript_sample "https://github.com/lingarobotics/lgc-learnlogic-code/blob/main/frontend/src/examples/ExampleTranscript.jsx"
click node_ai_response_page "https://github.com/lingarobotics/lgc-learnlogic-code/blob/main/frontend/src/pages/ExampleAIResponsePage.jsx"
click node_ai_response_sample "https://github.com/lingarobotics/lgc-learnlogic-code/blob/main/frontend/src/examples/ExampleAIResponse.jsx"

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,node_agenda,node_transcript toneBlue
class node_prompt,node_prompt_full,node_reading toneAmber
class node_example_hub,node_flow_guide,node_example_reading,node_example_transcript,node_transcript_sample,node_ai_response_page,node_ai_response_sample toneMint
class node_app,node_splash,node_wrapper toneRose
class node_learner,node_ai_tool toneIndigo
```

## Components

### Core Learning Flow

- [Home](https://github.com/lingarobotics/lgc-learnlogic-code/blob/main/frontend/src/pages/Home.jsx): `frontend/src/pages/Home.jsx`
- [Learning Agenda](https://github.com/lingarobotics/lgc-learnlogic-code/blob/main/frontend/src/pages/MainAgenda.jsx): `frontend/src/pages/MainAgenda.jsx`
- [Transcript Guidance](https://github.com/lingarobotics/lgc-learnlogic-code/blob/main/frontend/src/pages/Transcript.jsx): `frontend/src/pages/Transcript.jsx`

### AI Guidance

- [Prompt Overview](https://github.com/lingarobotics/lgc-learnlogic-code/blob/main/frontend/src/pages/AIPrompt.jsx): `frontend/src/pages/AIPrompt.jsx`
- [Full AI Prompt](https://github.com/lingarobotics/lgc-learnlogic-code/blob/main/frontend/src/pages/AIPromptFull.jsx): `frontend/src/pages/AIPromptFull.jsx`
- [Reading Guide](https://github.com/lingarobotics/lgc-learnlogic-code/blob/main/frontend/src/pages/ReadingGuide.jsx): `frontend/src/pages/ReadingGuide.jsx`

### Example Materials

- [Example Hub](https://github.com/lingarobotics/lgc-learnlogic-code/blob/main/frontend/src/pages/Example.jsx): `frontend/src/pages/Example.jsx`
- [Example Flow Guide](https://github.com/lingarobotics/lgc-learnlogic-code/blob/main/frontend/src/pages/ExampleFlowGuide.jsx): `frontend/src/pages/ExampleFlowGuide.jsx`
- [Example Reading Guide](https://github.com/lingarobotics/lgc-learnlogic-code/blob/main/frontend/src/pages/ExampleReadingGuidePage.jsx): `frontend/src/pages/ExampleReadingGuidePage.jsx`
- [Example Transcript Page](https://github.com/lingarobotics/lgc-learnlogic-code/blob/main/frontend/src/pages/ExampleTranscriptPage.jsx): `frontend/src/pages/ExampleTranscriptPage.jsx`
- [Transcript Sample](https://github.com/lingarobotics/lgc-learnlogic-code/blob/main/frontend/src/examples/ExampleTranscript.jsx): `frontend/src/examples/ExampleTranscript.jsx`
- [AI Response Page](https://github.com/lingarobotics/lgc-learnlogic-code/blob/main/frontend/src/pages/ExampleAIResponsePage.jsx): `frontend/src/pages/ExampleAIResponsePage.jsx`
- [AI Response Sample](https://github.com/lingarobotics/lgc-learnlogic-code/blob/main/frontend/src/examples/ExampleAIResponse.jsx): `frontend/src/examples/ExampleAIResponse.jsx`

### App Shell

- [Route App](https://github.com/lingarobotics/lgc-learnlogic-code/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Splash Screen](https://github.com/lingarobotics/lgc-learnlogic-code/blob/main/frontend/src/components/SplashScreen.jsx): `frontend/src/components/SplashScreen.jsx`
- [Page Wrapper](https://github.com/lingarobotics/lgc-learnlogic-code/blob/main/frontend/src/components/PageWrapper.jsx): `frontend/src/components/PageWrapper.jsx`

### Other components

- **Learner**
- **External AI Tool**

## Connections

- Learner → Route App: opens application (evidence: `README.md`)
- Route App → Splash Screen: renders (evidence: `frontend/src/App.jsx`)
- Route App → Home: routes to (evidence: `frontend/src/App.jsx`)
- Route App → Learning Agenda: routes to (evidence: `frontend/src/App.jsx`)
- Route App → Transcript Guidance: routes to (evidence: `frontend/src/App.jsx`)
- Route App → Prompt Overview: routes to (evidence: `frontend/src/App.jsx`)
- Route App → Full AI Prompt: routes to (evidence: `frontend/src/App.jsx`)
- Route App → Reading Guide: routes to (evidence: `frontend/src/App.jsx`)
- Route App → Example Hub: routes to (evidence: `frontend/src/App.jsx`)
- Route App → Example Flow Guide: routes to (evidence: `frontend/src/App.jsx`)
- Route App → Example Reading Guide: routes to (evidence: `frontend/src/App.jsx`)
- Route App → Example Transcript Page: routes to (evidence: `frontend/src/App.jsx`)
- Route App → AI Response Page: routes to (evidence: `frontend/src/App.jsx`)
- Home → Page Wrapper: renders within (evidence: `frontend/src/pages/Home.jsx`)
- Learning Agenda → Page Wrapper: renders within (evidence: `frontend/src/pages/MainAgenda.jsx`)
- Transcript Guidance → Page Wrapper: renders within (evidence: `frontend/src/pages/Transcript.jsx`)
- Prompt Overview → Page Wrapper: renders within (evidence: `frontend/src/pages/AIPrompt.jsx`)
- Full AI Prompt → Page Wrapper: renders within (evidence: `frontend/src/pages/AIPromptFull.jsx`)
- Reading Guide → Page Wrapper: renders within (evidence: `frontend/src/pages/ReadingGuide.jsx`)
- Example Hub → Page Wrapper: renders within (evidence: `frontend/src/pages/Example.jsx`)
- Example Flow Guide → Page Wrapper: renders within (evidence: `frontend/src/pages/ExampleFlowGuide.jsx`)
- Example Reading Guide → Page Wrapper: renders within (evidence: `frontend/src/pages/ExampleReadingGuidePage.jsx`)
- Example Transcript Page → Page Wrapper: renders within (evidence: `frontend/src/pages/ExampleTranscriptPage.jsx`)
- AI Response Page → Page Wrapper: renders within (evidence: `frontend/src/pages/ExampleAIResponsePage.jsx`)
- Home → Learning Agenda: continues to (evidence: `frontend/src/pages/Home.jsx`)
- Learning Agenda → Transcript Guidance: continues to (evidence: `frontend/src/pages/MainAgenda.jsx`)
- Transcript Guidance → Prompt Overview: continues to (evidence: `frontend/src/pages/Transcript.jsx`)
- Reading Guide → Example Reading Guide: applies to example (evidence: `frontend/src/pages/ReadingGuide.jsx`)
- Example Hub → Example Transcript Page: opens transcript (evidence: `frontend/src/pages/Example.jsx`)
- Example Hub → AI Response Page: opens response (evidence: `frontend/src/pages/Example.jsx`)
- Example Transcript Page → Transcript Sample: renders sample (evidence: `frontend/src/pages/ExampleTranscriptPage.jsx`)
- AI Response Page → AI Response Sample: renders sample (evidence: `frontend/src/pages/ExampleAIResponsePage.jsx`)
- Learner → External AI Tool: provides transcript and prompt (evidence: `README.md`)
