How solid-memo/website works
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: main.tsx Runtime setup · solidReviewStateRepository.ts Review repository · App.tsx Session app · deck.ts Deck and review model
Components 23
Web app
- Runtime setup
apps/web/src/main.tsx - Session app
apps/web/src/ui/App.tsx - Study workspace
apps/web/src/ui/Workspace.tsx - Screen routing
apps/web/src/ui/router.ts - Deck study
apps/web/src/ui/StudyContainer.tsx - Course chapters
apps/web/src/ui/CourseContainer.tsx - Deck library
apps/web/src/ui/LibraryContainer.tsx - Statistics
apps/web/src/ui/StatisticsContainer.tsx - Deck management
apps/web/src/ui/DeckDetailContainer.tsx
Application
- Use cases
packages/application/src/useCases.ts - Application ports
packages/application/src/ports.ts
Domain and validation
- Deck and review model
packages/domain/src/deck.ts - SHACL validation
packages/shacl/src/engine.ts
Pod and browser storage
- Deck repository
packages/solid/src/solidDeckRepository.ts - Review repository
packages/solid/src/solidReviewStateRepository.ts - Pod discovery
packages/solid/src/solidStorageGateway.ts - Other Pod adapters
packages/solid/src - RDF document I/O
packages/solid/src/datasets.ts - Review mapping
packages/solid/src/mappers/reviewStateMapper.ts - Guest Pod
packages/solid/src/localPod.ts - Browser resource store
packages/browser/src/indexedDbResourceStore.ts - Browser preferences
packages/browser/src/localStorageLanguagePreference.ts
Other components
- Learner
Connections 19
- Learner → Session app: uses
README.md - Runtime setup → Use cases: creates
apps/web/src/main.tsx - Runtime setup → Deck repository: configures
apps/web/src/main.tsx - Runtime setup → Review repository: configures
apps/web/src/main.tsx - Runtime setup → Pod discovery: configures
apps/web/src/main.tsx - Runtime setup → Other Pod adapters: configures
apps/web/src/main.tsx - Runtime setup → Guest Pod: creates
apps/web/src/main.tsx - Runtime setup → Browser resource store: creates
apps/web/src/main.tsx - Runtime setup → Session app: renders
apps/web/src/main.tsx - Session app → Study workspace: renders
apps/web/src/ui/App.tsx - Session app → Screen routing: uses
apps/web/src/ui/App.tsx - Use cases → Application ports: uses
packages/application/src/useCases.ts - Deck repository → RDF document I/O: reads and writes
packages/solid/src/solidDeckRepository.ts - Review repository → RDF document I/O: reads and writes
packages/solid/src/solidReviewStateRepository.ts - Review repository → Review mapping: maps records
packages/solid/src/solidReviewStateRepository.ts - Review mapping → Deck and review model: converts review state
packages/solid/src/mappers/reviewStateMapper.ts - Deck repository → Deck and review model: uses deck model
packages/solid/src/solidDeckRepository.ts - Review repository → Deck and review model: uses review model
packages/solid/src/solidReviewStateRepository.ts - SHACL validation → Deck and review model: formats violations
packages/shacl/src/engine.ts