# fadelilyas01/liraplus architecture

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

- Interactive diagram: https://gitdiagram.com/fadelilyas01/liraplus
- Repository: https://github.com/fadelilyas01/liraplus

## Overview

LiraPlus is an offline-first Flutter reading-support app for Québec primary-school students. A student opens the interactive reader, works through text with syllable-aware presentation and spoken feedback, and can use LSQ signing tools and accessibility profiles alongside reading. A separate camera workflow extracts text locally for reading. The README documents these capabilities and the main module responsibilities; sampled source excerpts cover only native platform shells, so runtime wiring between Dart components is not independently verified here.

Main entry points: [`lib/features/reader/reader_screen.dart`](https://github.com/fadelilyas01/liraplus/blob/main/lib/features/reader/reader_screen.dart) (Interactive reader), [`lib/core/providers/accessibility_provider.dart`](https://github.com/fadelilyas01/liraplus/blob/main/lib/core/providers/accessibility_provider.dart) (Accessibility state), [`lib/features/reader/presentation/alphabet_workshop_screen.dart`](https://github.com/fadelilyas01/liraplus/blob/main/lib/features/reader/presentation/alphabet_workshop_screen.dart) (Alphabet workshop), [`lib/main.dart`](https://github.com/fadelilyas01/liraplus/blob/main/lib/main.dart) (App entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and guidance"]
  node_entry["App entry<br/>[main.dart]"]
  node_faq["Help and FAQ<br/>[faq_screen.dart]"]
end

subgraph group_reading["Reading experience"]
  node_reader["Interactive reader<br/>[reader_screen.dart]"]
  node_textflow["Interactive text flow"]
  node_wordcoach["Word coach"]
  node_scanner["Local OCR scanner"]
  node_progress["Progress dashboard"]
end

subgraph group_signing["LSQ learning"]
  node_workshop["Alphabet workshop"]
  node_dactylology["Handshape viewer"]
  node_motion["Sign motion viewer"]
  node_lsqpanel["Reader LSQ panel"]
  node_speller["LSQ spelling player"]
  node_quiz["Alphabet quiz"]
  node_sign_data["Dactylology data"]
  node_semantic["LSQ semantic engine"]
end

subgraph group_core["Accessibility core"]
  node_syllabifier["French syllabifier"]
  node_falc["FALC dictionary"]
  node_speech["Speech and haptics"]
  node_accessibility["Accessibility state"]
  node_preferences[("Local preferences")]
  node_themes["Accessible themes"]
  node_announcer["Screen announcements"]
end

node_student(("Student"))

node_student -->|"opens app"| node_entry
node_entry -->|"starts reading"| node_reader
node_student -->|"captures text"| node_scanner
node_scanner -->|"provides extracted text"| node_reader
node_reader -->|"presents text"| node_textflow
node_reader -->|"segments syllables"| node_syllabifier
node_reader -->|"speaks touched words"| node_speech
node_reader -->|"opens word study"| node_wordcoach
node_wordcoach -->|"uses simplified text"| node_falc
node_reader -->|"shows LSQ support"| node_lsqpanel
node_lsqpanel -->|"presents sign motion"| node_motion
node_workshop -->|"teaches handshapes"| node_dactylology
node_workshop -->|"offers alphabet quiz"| node_quiz
node_dactylology -->|"uses letter data"| node_sign_data
node_reader -->|"spells text"| node_speller
node_speller -.->|"uses letter data"| node_sign_data
node_reader -.->|"supports LSQ meaning"| node_semantic
node_reader -->|"uses accessibility profiles"| node_accessibility
node_accessibility -->|"saves locally"| node_preferences
node_accessibility -->|"selects presentation"| node_themes
node_reader -.->|"announces accessibly"| node_announcer
node_reader -->|"tracks reading progress"| node_progress
node_student -->|"requests guidance"| node_faq

click node_entry "https://github.com/fadelilyas01/liraplus/blob/main/lib/main.dart"
click node_faq "https://github.com/fadelilyas01/liraplus/blob/main/lib/features/faq/faq_screen.dart"
click node_reader "https://github.com/fadelilyas01/liraplus/blob/main/lib/features/reader/reader_screen.dart"
click node_textflow "https://github.com/fadelilyas01/liraplus/blob/main/lib/features/reader/presentation/widgets/interactive_text_flow.dart"
click node_wordcoach "https://github.com/fadelilyas01/liraplus/blob/main/lib/features/reader/word_coach_sheet.dart"
click node_scanner "https://github.com/fadelilyas01/liraplus/blob/main/lib/features/scanner/ocr_camera_screen.dart"
click node_syllabifier "https://github.com/fadelilyas01/liraplus/blob/main/lib/core/nlp/french_syllabifier.dart"
click node_falc "https://github.com/fadelilyas01/liraplus/blob/main/lib/core/models/falc_dictionary.dart"
click node_speech "https://github.com/fadelilyas01/liraplus/blob/main/lib/core/services/tts_haptic_service.dart"
click node_accessibility "https://github.com/fadelilyas01/liraplus/blob/main/lib/core/providers/accessibility_provider.dart"
click node_preferences "https://github.com/fadelilyas01/liraplus/blob/main/lib/core/storage/preferences_repository.dart"
click node_themes "https://github.com/fadelilyas01/liraplus/blob/main/lib/core/theme/accessibility_themes.dart"
click node_announcer "https://github.com/fadelilyas01/liraplus/blob/main/lib/core/utils/accessibility_announcer.dart"
click node_workshop "https://github.com/fadelilyas01/liraplus/blob/main/lib/features/reader/presentation/alphabet_workshop_screen.dart"
click node_dactylology "https://github.com/fadelilyas01/liraplus/blob/main/lib/features/reader/presentation/widgets/dactylology_viewer.dart"
click node_motion "https://github.com/fadelilyas01/liraplus/blob/main/lib/features/reader/presentation/widgets/lsq_motion_viewer.dart"
click node_lsqpanel "https://github.com/fadelilyas01/liraplus/blob/main/lib/features/reader/presentation/widgets/lsq_reader_panel.dart"
click node_speller "https://github.com/fadelilyas01/liraplus/blob/main/lib/features/reader/presentation/widgets/lsq_speller_player.dart"
click node_quiz "https://github.com/fadelilyas01/liraplus/blob/main/lib/features/reader/presentation/widgets/alphabet_quiz_sheet.dart"
click node_sign_data "https://github.com/fadelilyas01/liraplus/blob/main/lib/core/models/dactylology_data.dart"
click node_semantic "https://github.com/fadelilyas01/liraplus/blob/main/lib/core/nlp/lsq_semantic_engine.dart"
click node_progress "https://github.com/fadelilyas01/liraplus/blob/main/lib/features/reader/presentation/widgets/progression_dashboard_sheet.dart"

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_faq toneBlue
class node_reader,node_textflow,node_wordcoach,node_scanner,node_progress toneAmber
class node_workshop,node_dactylology,node_motion,node_lsqpanel,node_speller,node_quiz,node_sign_data,node_semantic toneMint
class node_syllabifier,node_falc,node_speech,node_accessibility,node_preferences,node_themes,node_announcer toneRose
class node_student toneIndigo
```

## Components

### App and guidance

- [App entry](https://github.com/fadelilyas01/liraplus/blob/main/lib/main.dart): `lib/main.dart`
- [Help and FAQ](https://github.com/fadelilyas01/liraplus/blob/main/lib/features/faq/faq_screen.dart): `lib/features/faq/faq_screen.dart`

### Reading experience

- [Interactive reader](https://github.com/fadelilyas01/liraplus/blob/main/lib/features/reader/reader_screen.dart): `lib/features/reader/reader_screen.dart`
- [Interactive text flow](https://github.com/fadelilyas01/liraplus/blob/main/lib/features/reader/presentation/widgets/interactive_text_flow.dart): `lib/features/reader/presentation/widgets/interactive_text_flow.dart`
- [Word coach](https://github.com/fadelilyas01/liraplus/blob/main/lib/features/reader/word_coach_sheet.dart): `lib/features/reader/word_coach_sheet.dart`
- [Local OCR scanner](https://github.com/fadelilyas01/liraplus/blob/main/lib/features/scanner/ocr_camera_screen.dart): `lib/features/scanner/ocr_camera_screen.dart`
- [Progress dashboard](https://github.com/fadelilyas01/liraplus/blob/main/lib/features/reader/presentation/widgets/progression_dashboard_sheet.dart): `lib/features/reader/presentation/widgets/progression_dashboard_sheet.dart`

### LSQ learning

- [Alphabet workshop](https://github.com/fadelilyas01/liraplus/blob/main/lib/features/reader/presentation/alphabet_workshop_screen.dart): `lib/features/reader/presentation/alphabet_workshop_screen.dart`
- [Handshape viewer](https://github.com/fadelilyas01/liraplus/blob/main/lib/features/reader/presentation/widgets/dactylology_viewer.dart): `lib/features/reader/presentation/widgets/dactylology_viewer.dart`
- [Sign motion viewer](https://github.com/fadelilyas01/liraplus/blob/main/lib/features/reader/presentation/widgets/lsq_motion_viewer.dart): `lib/features/reader/presentation/widgets/lsq_motion_viewer.dart`
- [Reader LSQ panel](https://github.com/fadelilyas01/liraplus/blob/main/lib/features/reader/presentation/widgets/lsq_reader_panel.dart): `lib/features/reader/presentation/widgets/lsq_reader_panel.dart`
- [LSQ spelling player](https://github.com/fadelilyas01/liraplus/blob/main/lib/features/reader/presentation/widgets/lsq_speller_player.dart): `lib/features/reader/presentation/widgets/lsq_speller_player.dart`
- [Alphabet quiz](https://github.com/fadelilyas01/liraplus/blob/main/lib/features/reader/presentation/widgets/alphabet_quiz_sheet.dart): `lib/features/reader/presentation/widgets/alphabet_quiz_sheet.dart`
- [Dactylology data](https://github.com/fadelilyas01/liraplus/blob/main/lib/core/models/dactylology_data.dart): `lib/core/models/dactylology_data.dart`
- [LSQ semantic engine](https://github.com/fadelilyas01/liraplus/blob/main/lib/core/nlp/lsq_semantic_engine.dart): `lib/core/nlp/lsq_semantic_engine.dart`

### Accessibility core

- [French syllabifier](https://github.com/fadelilyas01/liraplus/blob/main/lib/core/nlp/french_syllabifier.dart): `lib/core/nlp/french_syllabifier.dart`
- [FALC dictionary](https://github.com/fadelilyas01/liraplus/blob/main/lib/core/models/falc_dictionary.dart): `lib/core/models/falc_dictionary.dart`
- [Speech and haptics](https://github.com/fadelilyas01/liraplus/blob/main/lib/core/services/tts_haptic_service.dart): `lib/core/services/tts_haptic_service.dart`
- [Accessibility state](https://github.com/fadelilyas01/liraplus/blob/main/lib/core/providers/accessibility_provider.dart): `lib/core/providers/accessibility_provider.dart`
- [Local preferences](https://github.com/fadelilyas01/liraplus/blob/main/lib/core/storage/preferences_repository.dart): `lib/core/storage/preferences_repository.dart`
- [Accessible themes](https://github.com/fadelilyas01/liraplus/blob/main/lib/core/theme/accessibility_themes.dart): `lib/core/theme/accessibility_themes.dart`
- [Screen announcements](https://github.com/fadelilyas01/liraplus/blob/main/lib/core/utils/accessibility_announcer.dart): `lib/core/utils/accessibility_announcer.dart`

### Other components

- **Student**

## Connections

- Student → App entry: opens app (evidence: `README.md`)
- App entry → Interactive reader: starts reading (evidence: `README.md`)
- Student → Local OCR scanner: captures text (evidence: `README.md`)
- Local OCR scanner → Interactive reader: provides extracted text (evidence: `README.md`)
- Interactive reader → Interactive text flow: presents text (evidence: `README.md`)
- Interactive reader → French syllabifier: segments syllables (evidence: `README.md`)
- Interactive reader → Speech and haptics: speaks touched words (evidence: `README.md`)
- Interactive reader → Word coach: opens word study (evidence: `README.md`)
- Word coach → FALC dictionary: uses simplified text (evidence: `README.md`)
- Interactive reader → Reader LSQ panel: shows LSQ support (evidence: `README.md`)
- Reader LSQ panel → Sign motion viewer: presents sign motion (evidence: `README.md`)
- Alphabet workshop → Handshape viewer: teaches handshapes (evidence: `README.md`)
- Alphabet workshop → Alphabet quiz: offers alphabet quiz (evidence: `README.md`)
- Handshape viewer → Dactylology data: uses letter data (evidence: `README.md`)
- Interactive reader → LSQ spelling player: spells text (evidence: `README.md`)
- LSQ spelling player → Dactylology data: uses letter data
- Interactive reader → LSQ semantic engine: supports LSQ meaning
- Interactive reader → Accessibility state: uses accessibility profiles (evidence: `README.md`)
- Accessibility state → Local preferences: saves locally (evidence: `README.md`)
- Accessibility state → Accessible themes: selects presentation (evidence: `README.md`)
- Interactive reader → Screen announcements: announces accessibly
- Interactive reader → Progress dashboard: tracks reading progress (evidence: `README.md`)
- Student → Help and FAQ: requests guidance (evidence: `README.md`)
