# solid-memo/website architecture

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

- Interactive diagram: https://gitdiagram.com/solid-memo/website
- Repository: https://github.com/solid-memo/website

## Overview

Solid Memo is a spaced-repetition flashcard app whose records live in the user’s Solid Pod, with a local guest mode. The user connects a Pod or studies as a guest, works through decks and reviews, and the app persists study state; the web entry point wires application use cases to Solid and browser adapters before rendering the UI. The tree also exposes deck/library management, courses and chapter study, statistics, migration, validation, repair, and preferences. Several feature modules were not sampled, so their presence is shown without speculative call links.

Main entry points: [`apps/web/src/main.tsx`](https://github.com/solid-memo/website/blob/main/apps/web/src/main.tsx) (Runtime setup), [`packages/solid/src/solidReviewStateRepository.ts`](https://github.com/solid-memo/website/blob/main/packages/solid/src/solidReviewStateRepository.ts) (Review repository), [`apps/web/src/ui/App.tsx`](https://github.com/solid-memo/website/blob/main/apps/web/src/ui/App.tsx) (Session app), [`packages/domain/src/deck.ts`](https://github.com/solid-memo/website/blob/main/packages/domain/src/deck.ts) (Deck and review model)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web app"]
  node_entry["Runtime setup<br/>[main.tsx]"]
  node_app["Session app<br/>[App.tsx]"]
  node_workspace["Study workspace<br/>[Workspace.tsx]"]
  node_routing["Screen routing<br/>[router.ts]"]
  node_deck_study["Deck study<br/>[StudyContainer.tsx]"]
  node_course_study["Course chapters"]
  node_library_ui["Deck library"]
  node_stats_ui["Statistics"]
  node_management_ui["Deck management"]
end

subgraph group_application["Application"]
  node_usecases["Use cases<br/>[useCases.ts]"]
  node_ports["Application ports<br/>[ports.ts]"]
end

subgraph group_domain["Domain and validation"]
  node_domain["Deck and review model<br/>[deck.ts]"]
  node_shacl["SHACL validation<br/>[engine.ts]"]
end

subgraph group_persistence["Pod and browser storage"]
  node_deck_repo["Deck repository"]
  node_review_repo["Review repository"]
  node_storage_gateway["Pod discovery"]
  node_solid_adapters["Other Pod adapters"]
  node_dataset_io["RDF document I/O<br/>[datasets.ts]"]
  node_review_mapper["Review mapping"]
  node_guest_pod["Guest Pod<br/>[localPod.ts]"]
  node_browser_store[("Browser resource store")]
  node_preferences["Browser preferences"]
end

node_user(("Learner"))

node_user -->|"uses"| node_app
node_entry -->|"creates"| node_usecases
node_entry -->|"configures"| node_deck_repo
node_entry -->|"configures"| node_review_repo
node_entry -->|"configures"| node_storage_gateway
node_entry -->|"configures"| node_solid_adapters
node_entry -->|"creates"| node_guest_pod
node_entry -->|"creates"| node_browser_store
node_entry -->|"renders"| node_app
node_app -->|"renders"| node_workspace
node_app -->|"uses"| node_routing
node_usecases -->|"uses"| node_ports
node_deck_repo -->|"reads and writes"| node_dataset_io
node_review_repo -->|"reads and writes"| node_dataset_io
node_review_repo -->|"maps records"| node_review_mapper
node_review_mapper -->|"converts review state"| node_domain
node_deck_repo -->|"uses deck model"| node_domain
node_review_repo -->|"uses review model"| node_domain
node_shacl -->|"formats violations"| node_domain

click node_entry "https://github.com/solid-memo/website/blob/main/apps/web/src/main.tsx"
click node_app "https://github.com/solid-memo/website/blob/main/apps/web/src/ui/App.tsx"
click node_workspace "https://github.com/solid-memo/website/blob/main/apps/web/src/ui/Workspace.tsx"
click node_routing "https://github.com/solid-memo/website/blob/main/apps/web/src/ui/router.ts"
click node_deck_study "https://github.com/solid-memo/website/blob/main/apps/web/src/ui/StudyContainer.tsx"
click node_course_study "https://github.com/solid-memo/website/blob/main/apps/web/src/ui/CourseContainer.tsx"
click node_library_ui "https://github.com/solid-memo/website/blob/main/apps/web/src/ui/LibraryContainer.tsx"
click node_stats_ui "https://github.com/solid-memo/website/blob/main/apps/web/src/ui/StatisticsContainer.tsx"
click node_management_ui "https://github.com/solid-memo/website/blob/main/apps/web/src/ui/DeckDetailContainer.tsx"
click node_usecases "https://github.com/solid-memo/website/blob/main/packages/application/src/useCases.ts"
click node_ports "https://github.com/solid-memo/website/blob/main/packages/application/src/ports.ts"
click node_domain "https://github.com/solid-memo/website/blob/main/packages/domain/src/deck.ts"
click node_shacl "https://github.com/solid-memo/website/blob/main/packages/shacl/src/engine.ts"
click node_deck_repo "https://github.com/solid-memo/website/blob/main/packages/solid/src/solidDeckRepository.ts"
click node_review_repo "https://github.com/solid-memo/website/blob/main/packages/solid/src/solidReviewStateRepository.ts"
click node_storage_gateway "https://github.com/solid-memo/website/blob/main/packages/solid/src/solidStorageGateway.ts"
click node_solid_adapters "https://github.com/solid-memo/website/tree/main/packages/solid/src"
click node_dataset_io "https://github.com/solid-memo/website/blob/main/packages/solid/src/datasets.ts"
click node_review_mapper "https://github.com/solid-memo/website/blob/main/packages/solid/src/mappers/reviewStateMapper.ts"
click node_guest_pod "https://github.com/solid-memo/website/blob/main/packages/solid/src/localPod.ts"
click node_browser_store "https://github.com/solid-memo/website/blob/main/packages/browser/src/indexedDbResourceStore.ts"
click node_preferences "https://github.com/solid-memo/website/blob/main/packages/browser/src/localStorageLanguagePreference.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_entry,node_app,node_workspace,node_routing,node_deck_study,node_course_study,node_library_ui,node_stats_ui,node_management_ui toneBlue
class node_usecases,node_ports toneAmber
class node_domain,node_shacl toneMint
class node_deck_repo,node_review_repo,node_storage_gateway,node_solid_adapters,node_dataset_io,node_review_mapper,node_guest_pod,node_browser_store,node_preferences toneRose
class node_user toneIndigo
```

## Components

### Web app

- [Runtime setup](https://github.com/solid-memo/website/blob/main/apps/web/src/main.tsx): `apps/web/src/main.tsx`
- [Session app](https://github.com/solid-memo/website/blob/main/apps/web/src/ui/App.tsx): `apps/web/src/ui/App.tsx`
- [Study workspace](https://github.com/solid-memo/website/blob/main/apps/web/src/ui/Workspace.tsx): `apps/web/src/ui/Workspace.tsx`
- [Screen routing](https://github.com/solid-memo/website/blob/main/apps/web/src/ui/router.ts): `apps/web/src/ui/router.ts`
- [Deck study](https://github.com/solid-memo/website/blob/main/apps/web/src/ui/StudyContainer.tsx): `apps/web/src/ui/StudyContainer.tsx`
- [Course chapters](https://github.com/solid-memo/website/blob/main/apps/web/src/ui/CourseContainer.tsx): `apps/web/src/ui/CourseContainer.tsx`
- [Deck library](https://github.com/solid-memo/website/blob/main/apps/web/src/ui/LibraryContainer.tsx): `apps/web/src/ui/LibraryContainer.tsx`
- [Statistics](https://github.com/solid-memo/website/blob/main/apps/web/src/ui/StatisticsContainer.tsx): `apps/web/src/ui/StatisticsContainer.tsx`
- [Deck management](https://github.com/solid-memo/website/blob/main/apps/web/src/ui/DeckDetailContainer.tsx): `apps/web/src/ui/DeckDetailContainer.tsx`

### Application

- [Use cases](https://github.com/solid-memo/website/blob/main/packages/application/src/useCases.ts): `packages/application/src/useCases.ts`
- [Application ports](https://github.com/solid-memo/website/blob/main/packages/application/src/ports.ts): `packages/application/src/ports.ts`

### Domain and validation

- [Deck and review model](https://github.com/solid-memo/website/blob/main/packages/domain/src/deck.ts): `packages/domain/src/deck.ts`
- [SHACL validation](https://github.com/solid-memo/website/blob/main/packages/shacl/src/engine.ts): `packages/shacl/src/engine.ts`

### Pod and browser storage

- [Deck repository](https://github.com/solid-memo/website/blob/main/packages/solid/src/solidDeckRepository.ts): `packages/solid/src/solidDeckRepository.ts`
- [Review repository](https://github.com/solid-memo/website/blob/main/packages/solid/src/solidReviewStateRepository.ts): `packages/solid/src/solidReviewStateRepository.ts`
- [Pod discovery](https://github.com/solid-memo/website/blob/main/packages/solid/src/solidStorageGateway.ts): `packages/solid/src/solidStorageGateway.ts`
- [Other Pod adapters](https://github.com/solid-memo/website/tree/main/packages/solid/src): `packages/solid/src`
- [RDF document I/O](https://github.com/solid-memo/website/blob/main/packages/solid/src/datasets.ts): `packages/solid/src/datasets.ts`
- [Review mapping](https://github.com/solid-memo/website/blob/main/packages/solid/src/mappers/reviewStateMapper.ts): `packages/solid/src/mappers/reviewStateMapper.ts`
- [Guest Pod](https://github.com/solid-memo/website/blob/main/packages/solid/src/localPod.ts): `packages/solid/src/localPod.ts`
- [Browser resource store](https://github.com/solid-memo/website/blob/main/packages/browser/src/indexedDbResourceStore.ts): `packages/browser/src/indexedDbResourceStore.ts`
- [Browser preferences](https://github.com/solid-memo/website/blob/main/packages/browser/src/localStorageLanguagePreference.ts): `packages/browser/src/localStorageLanguagePreference.ts`

### Other components

- **Learner**

## Connections

- Learner → Session app: uses (evidence: `README.md`)
- Runtime setup → Use cases: creates (evidence: `apps/web/src/main.tsx`)
- Runtime setup → Deck repository: configures (evidence: `apps/web/src/main.tsx`)
- Runtime setup → Review repository: configures (evidence: `apps/web/src/main.tsx`)
- Runtime setup → Pod discovery: configures (evidence: `apps/web/src/main.tsx`)
- Runtime setup → Other Pod adapters: configures (evidence: `apps/web/src/main.tsx`)
- Runtime setup → Guest Pod: creates (evidence: `apps/web/src/main.tsx`)
- Runtime setup → Browser resource store: creates (evidence: `apps/web/src/main.tsx`)
- Runtime setup → Session app: renders (evidence: `apps/web/src/main.tsx`)
- Session app → Study workspace: renders (evidence: `apps/web/src/ui/App.tsx`)
- Session app → Screen routing: uses (evidence: `apps/web/src/ui/App.tsx`)
- Use cases → Application ports: uses (evidence: `packages/application/src/useCases.ts`)
- Deck repository → RDF document I/O: reads and writes (evidence: `packages/solid/src/solidDeckRepository.ts`)
- Review repository → RDF document I/O: reads and writes (evidence: `packages/solid/src/solidReviewStateRepository.ts`)
- Review repository → Review mapping: maps records (evidence: `packages/solid/src/solidReviewStateRepository.ts`)
- Review mapping → Deck and review model: converts review state (evidence: `packages/solid/src/mappers/reviewStateMapper.ts`)
- Deck repository → Deck and review model: uses deck model (evidence: `packages/solid/src/solidDeckRepository.ts`)
- Review repository → Deck and review model: uses review model (evidence: `packages/solid/src/solidReviewStateRepository.ts`)
- SHACL validation → Deck and review model: formats violations (evidence: `packages/shacl/src/engine.ts`)
