# dhakadstudio/devora-react-web architecture

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

- Interactive diagram: https://gitdiagram.com/dhakadstudio/devora-react-web
- Repository: https://github.com/dhakadstudio/devora-react-web

## Overview

Devora is a browser-based programming-learning platform. Learners browse curriculum paths, open lessons and challenges, work through instructional stages and exercises, run code, and track progress; guided projects and a standalone playground extend that core journey. The graph separates UI routing, curriculum and learning logic, execution, and user progress/persistence. Evidence is limited to the README, supplied excerpts, and SOURCE INDEX references; unsampled pages and integrations are represented only where their presence or relationship is documented.

Main entry points: [`src/engines/execution/index.ts`](https://github.com/dhakadstudio/devora-react-web/blob/main/src/engines/execution/index.ts) (Execution router), [`src/pages/Lesson.tsx`](https://github.com/dhakadstudio/devora-react-web/blob/main/src/pages/Lesson.tsx) (Lesson workspace), [`src/App.tsx`](https://github.com/dhakadstudio/devora-react-web/blob/main/src/App.tsx) (App routing), [`src/engines/progress/index.ts`](https://github.com/dhakadstudio/devora-react-web/blob/main/src/engines/progress/index.ts) (Progress API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application UI"]
  node_app["App routing<br/>[App.tsx]"]
  node_landing["Landing experience<br/>[Landing.tsx]"]
  node_lesson["Lesson workspace<br/>[Lesson.tsx]"]
  node_challenge["Challenge detail"]
  node_project["Guided project<br/>[Project.tsx]"]
  node_playground["Playground workbench<br/>[Workbench.tsx]"]
  node_editor["Code editor<br/>[CodeEditor.tsx]"]
end

subgraph group_learning["Curriculum and Learning"]
  node_curriculum["Curriculum service<br/>[index.ts]"]
  node_content["Content parsing<br/>[content.ts]"]
  node_stages["Lesson stages<br/>[stages.ts]"]
  node_exercise["Exercise logic<br/>[exercise.ts]"]
  node_projectservice["Project service<br/>[index.ts]"]
end

subgraph group_execution["Code Execution"]
  node_execution["Execution router<br/>[index.ts]"]
  node_browserjs["Browser JavaScript<br/>[browser-js.ts]"]
  node_judge0["Judge0 runner<br/>[judge0.ts]"]
  node_interactive["Interactive runner<br/>[interactive.ts]"]
end

subgraph group_state["Identity and Progress"]
  node_auth["Authentication<br/>[auth.tsx]"]
  node_progress["Progress API<br/>[index.ts]"]
  node_progressstore[("Local progress store<br/>[store.ts]")]
end

node_learner(("Learner"))
node_supabase[("Supabase")]

node_learner -->|"opens"| node_app
node_app -->|"routes to"| node_landing
node_app -->|"routes to"| node_lesson
node_app -->|"routes to"| node_challenge
node_lesson -->|"loads curriculum"| node_curriculum
node_lesson -->|"uses stages"| node_stages
node_lesson -->|"uses exercises"| node_exercise
node_lesson -->|"runs code"| node_execution
node_lesson -->|"records progress"| node_progress
node_challenge -->|"runs code"| node_execution
node_challenge -->|"records attempts"| node_progress
node_project -->|"loads and submits"| node_projectservice
node_projectservice -->|"reads and writes"| node_supabase
node_landing -->|"runs demo"| node_execution
node_playground -->|"renders"| node_editor
node_playground -->|"dispatches code"| node_execution
node_curriculum -->|"parses content"| node_content
node_curriculum -->|"queries curriculum"| node_supabase
node_execution -->|"dispatches JavaScript"| node_browserjs
node_execution -->|"dispatches languages"| node_judge0
node_execution -->|"exports runner"| node_interactive
node_progress -->|"gets user"| node_auth
node_progress -->|"reads and updates"| node_progressstore
node_auth -->|"authenticates users"| node_supabase
node_learner -.->|"builds project"| node_project
node_learner -.->|"practices code"| node_playground

click node_app "https://github.com/dhakadstudio/devora-react-web/blob/main/src/App.tsx"
click node_landing "https://github.com/dhakadstudio/devora-react-web/blob/main/src/pages/Landing.tsx"
click node_lesson "https://github.com/dhakadstudio/devora-react-web/blob/main/src/pages/Lesson.tsx"
click node_challenge "https://github.com/dhakadstudio/devora-react-web/blob/main/src/pages/ChallengeDetail.tsx"
click node_project "https://github.com/dhakadstudio/devora-react-web/blob/main/src/pages/Project.tsx"
click node_playground "https://github.com/dhakadstudio/devora-react-web/blob/main/src/components/Workbench.tsx"
click node_editor "https://github.com/dhakadstudio/devora-react-web/blob/main/src/components/CodeEditor.tsx"
click node_curriculum "https://github.com/dhakadstudio/devora-react-web/blob/main/src/engines/curriculum/index.ts"
click node_content "https://github.com/dhakadstudio/devora-react-web/blob/main/src/engines/curriculum/content.ts"
click node_stages "https://github.com/dhakadstudio/devora-react-web/blob/main/src/engines/learning/stages.ts"
click node_exercise "https://github.com/dhakadstudio/devora-react-web/blob/main/src/engines/learning/exercise.ts"
click node_execution "https://github.com/dhakadstudio/devora-react-web/blob/main/src/engines/execution/index.ts"
click node_browserjs "https://github.com/dhakadstudio/devora-react-web/blob/main/src/engines/execution/browser-js.ts"
click node_judge0 "https://github.com/dhakadstudio/devora-react-web/blob/main/src/engines/execution/judge0.ts"
click node_interactive "https://github.com/dhakadstudio/devora-react-web/blob/main/src/engines/execution/interactive.ts"
click node_auth "https://github.com/dhakadstudio/devora-react-web/blob/main/src/lib/auth.tsx"
click node_progress "https://github.com/dhakadstudio/devora-react-web/blob/main/src/engines/progress/index.ts"
click node_progressstore "https://github.com/dhakadstudio/devora-react-web/blob/main/src/engines/progress/store.ts"
click node_projectservice "https://github.com/dhakadstudio/devora-react-web/blob/main/src/engines/project/index.ts"

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_landing,node_lesson,node_challenge,node_project,node_playground,node_editor toneBlue
class node_curriculum,node_content,node_stages,node_exercise,node_projectservice,node_supabase toneAmber
class node_execution,node_browserjs,node_judge0,node_interactive toneMint
class node_auth,node_progress,node_progressstore toneRose
class node_learner toneIndigo
```

## Components

### Application UI

- [App routing](https://github.com/dhakadstudio/devora-react-web/blob/main/src/App.tsx): `src/App.tsx`
- [Landing experience](https://github.com/dhakadstudio/devora-react-web/blob/main/src/pages/Landing.tsx): `src/pages/Landing.tsx`
- [Lesson workspace](https://github.com/dhakadstudio/devora-react-web/blob/main/src/pages/Lesson.tsx): `src/pages/Lesson.tsx`
- [Challenge detail](https://github.com/dhakadstudio/devora-react-web/blob/main/src/pages/ChallengeDetail.tsx): `src/pages/ChallengeDetail.tsx`
- [Guided project](https://github.com/dhakadstudio/devora-react-web/blob/main/src/pages/Project.tsx): `src/pages/Project.tsx`
- [Playground workbench](https://github.com/dhakadstudio/devora-react-web/blob/main/src/components/Workbench.tsx): `src/components/Workbench.tsx`
- [Code editor](https://github.com/dhakadstudio/devora-react-web/blob/main/src/components/CodeEditor.tsx): `src/components/CodeEditor.tsx`

### Curriculum and Learning

- [Curriculum service](https://github.com/dhakadstudio/devora-react-web/blob/main/src/engines/curriculum/index.ts): `src/engines/curriculum/index.ts`
- [Content parsing](https://github.com/dhakadstudio/devora-react-web/blob/main/src/engines/curriculum/content.ts): `src/engines/curriculum/content.ts`
- [Lesson stages](https://github.com/dhakadstudio/devora-react-web/blob/main/src/engines/learning/stages.ts): `src/engines/learning/stages.ts`
- [Exercise logic](https://github.com/dhakadstudio/devora-react-web/blob/main/src/engines/learning/exercise.ts): `src/engines/learning/exercise.ts`
- [Project service](https://github.com/dhakadstudio/devora-react-web/blob/main/src/engines/project/index.ts): `src/engines/project/index.ts`

### Code Execution

- [Execution router](https://github.com/dhakadstudio/devora-react-web/blob/main/src/engines/execution/index.ts): `src/engines/execution/index.ts`
- [Browser JavaScript](https://github.com/dhakadstudio/devora-react-web/blob/main/src/engines/execution/browser-js.ts): `src/engines/execution/browser-js.ts`
- [Judge0 runner](https://github.com/dhakadstudio/devora-react-web/blob/main/src/engines/execution/judge0.ts): `src/engines/execution/judge0.ts`
- [Interactive runner](https://github.com/dhakadstudio/devora-react-web/blob/main/src/engines/execution/interactive.ts): `src/engines/execution/interactive.ts`

### Identity and Progress

- [Authentication](https://github.com/dhakadstudio/devora-react-web/blob/main/src/lib/auth.tsx): `src/lib/auth.tsx`
- [Progress API](https://github.com/dhakadstudio/devora-react-web/blob/main/src/engines/progress/index.ts): `src/engines/progress/index.ts`
- [Local progress store](https://github.com/dhakadstudio/devora-react-web/blob/main/src/engines/progress/store.ts): `src/engines/progress/store.ts`

### Other components

- **Learner**
- **Supabase**

## Connections

- Learner → App routing: opens (evidence: `src/App.tsx`)
- App routing → Landing experience: routes to (evidence: `src/App.tsx`)
- App routing → Lesson workspace: routes to (evidence: `src/App.tsx`)
- App routing → Challenge detail: routes to (evidence: `src/App.tsx`)
- Lesson workspace → Curriculum service: loads curriculum (evidence: `src/pages/Lesson.tsx`)
- Lesson workspace → Lesson stages: uses stages (evidence: `src/pages/Lesson.tsx`)
- Lesson workspace → Exercise logic: uses exercises (evidence: `src/pages/Lesson.tsx`)
- Lesson workspace → Execution router: runs code (evidence: `src/pages/Lesson.tsx`)
- Lesson workspace → Progress API: records progress (evidence: `src/pages/Lesson.tsx`)
- Challenge detail → Execution router: runs code (evidence: `src/pages/ChallengeDetail.tsx`)
- Challenge detail → Progress API: records attempts (evidence: `src/pages/ChallengeDetail.tsx`)
- Guided project → Project service: loads and submits (evidence: `src/pages/Project.tsx`)
- Project service → Supabase: reads and writes (evidence: `src/engines/project/index.ts`)
- Landing experience → Execution router: runs demo (evidence: `src/pages/Landing.tsx`)
- Playground workbench → Code editor: renders (evidence: `src/components/Workbench.tsx`)
- Playground workbench → Execution router: dispatches code (evidence: `src/components/Workbench.tsx`)
- Curriculum service → Content parsing: parses content (evidence: `src/engines/curriculum/index.ts`)
- Curriculum service → Supabase: queries curriculum (evidence: `src/engines/curriculum/index.ts`)
- Execution router → Browser JavaScript: dispatches JavaScript (evidence: `src/engines/execution/index.ts`)
- Execution router → Judge0 runner: dispatches languages (evidence: `src/engines/execution/index.ts`)
- Execution router → Interactive runner: exports runner (evidence: `src/engines/execution/index.ts`)
- Progress API → Authentication: gets user (evidence: `src/engines/progress/index.ts`)
- Progress API → Local progress store: reads and updates (evidence: `src/engines/progress/index.ts`)
- Authentication → Supabase: authenticates users (evidence: `src/lib/auth.tsx`)
- Learner → Guided project: builds project
- Learner → Playground workbench: practices code
