# issey-wu/6onsix architecture

> Architecture diagram of the GitHub repository issey-wu/6onsix, 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/issey-wu/6onsix
- Repository: https://github.com/issey-wu/6onsix

## Overview

6 On Six is an offline Flutter volleyball-learning app. The main user journey is to open a lesson, answer activities with immediate feedback, and build progression that supports streaks and review. Its documented subject matter includes court positions, roles, terminology, rotations, and the 5-1 system. The tree shows shared course/progress models, asset-backed course data, and a local database implementation, as well as separate glossary, avatar, goal, quest, and profile screens. Library source was not excerpted, so internal wiring is shown only as unverified dashed links.

Main entry points: [`lib/features/lesson/presentation/lesson_screen.dart`](https://github.com/issey-wu/6onsix/blob/main/lib/features/lesson/presentation/lesson_screen.dart) (Lesson activities), [`lib/features/learning_path/presentation/home_screen.dart`](https://github.com/issey-wu/6onsix/blob/main/lib/features/learning_path/presentation/home_screen.dart) (Learning path), [`lib/app/app.dart`](https://github.com/issey-wu/6onsix/blob/main/lib/app/app.dart) (Flutter app), [`lib/core/data/drift_progress_repository.dart`](https://github.com/issey-wu/6onsix/blob/main/lib/core/data/drift_progress_repository.dart) (Progress repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_application["App shell"]
  node_app["Flutter app<br/>[app.dart]"]
  node_bootstrap["App bootstrap<br/>[bootstrap.dart]"]
  node_router["Navigation<br/>[router.dart]"]
end

subgraph group_learning["Learning experience"]
  node_home["Learning path<br/>[home_screen.dart]"]
  node_lesson["Lesson activities<br/>[lesson_screen.dart]"]
  node_dragdrop["Drag and drop"]
  node_matching["Matching activity<br/>[matching_view.dart]"]
  node_lessonfeedback["Lesson feedback<br/>[feedback.dart]"]
end

subgraph group_shared["Shared domain"]
  node_course["Course model<br/>[course.dart]"]
  node_rules["Game rules<br/>[game_rules.dart]"]
  node_session["Lesson session"]
  node_motivation["Motivation and streaks<br/>[motivation.dart]"]
  node_progress["Progress state<br/>[progress.dart]"]
end

subgraph group_offline["Offline data"]
  node_contentrepo["Asset content repository"]
  node_courseparser["Course parser<br/>[course_parser.dart]"]
  node_courseasset["Course content<br/>[course.json]"]
  node_database[("Local database<br/>[database.dart]")]
  node_progressrepo["Progress repository"]
end

subgraph group_supporting["Learner features"]
  node_glossary["Glossary"]
  node_avatar["Avatar<br/>[avatar_screen.dart]"]
  node_goal["Goal setting<br/>[goal_screen.dart]"]
  node_quests["Quests<br/>[quests_screen.dart]"]
  node_profile["Profile and settings"]
end

node_learner(("Learner"))

node_learner -->|"uses"| node_app
node_app -.->|"starts"| node_bootstrap
node_app -.->|"navigates via"| node_router
node_learner -->|"learns through"| node_home
node_home -.->|"opens lessons"| node_lesson
node_lesson -.->|"presents activity"| node_dragdrop
node_lesson -.->|"presents activity"| node_matching
node_lesson -->|"shows feedback"| node_lessonfeedback
node_lesson -.->|"uses session"| node_session
node_lesson -.->|"applies rules"| node_rules
node_home -.->|"shows course"| node_course
node_contentrepo -.->|"loads content"| node_courseasset
node_contentrepo -.->|"parses content"| node_courseparser
node_lesson -.->|"records progress"| node_progressrepo
node_progressrepo -.->|"persists progress"| node_database
node_progressrepo -.->|"stores state"| node_progress
node_home -->|"shows progression"| node_progress
node_progress -.->|"supports streaks"| node_motivation
node_learner -->|"looks up terms"| node_glossary
node_learner -.->|"customizes avatar"| node_avatar
node_learner -.->|"sets goals"| node_goal
node_learner -.->|"reviews quests"| node_quests
node_learner -.->|"manages profile"| node_profile

click node_app "https://github.com/issey-wu/6onsix/blob/main/lib/app/app.dart"
click node_bootstrap "https://github.com/issey-wu/6onsix/blob/main/lib/app/bootstrap.dart"
click node_router "https://github.com/issey-wu/6onsix/blob/main/lib/app/router.dart"
click node_home "https://github.com/issey-wu/6onsix/blob/main/lib/features/learning_path/presentation/home_screen.dart"
click node_lesson "https://github.com/issey-wu/6onsix/blob/main/lib/features/lesson/presentation/lesson_screen.dart"
click node_dragdrop "https://github.com/issey-wu/6onsix/blob/main/lib/features/lesson/presentation/drag_drop_view.dart"
click node_matching "https://github.com/issey-wu/6onsix/blob/main/lib/features/lesson/presentation/matching_view.dart"
click node_lessonfeedback "https://github.com/issey-wu/6onsix/blob/main/lib/app/feedback.dart"
click node_course "https://github.com/issey-wu/6onsix/blob/main/lib/core/domain/course.dart"
click node_rules "https://github.com/issey-wu/6onsix/blob/main/lib/core/domain/game_rules.dart"
click node_session "https://github.com/issey-wu/6onsix/blob/main/lib/core/domain/lesson_session.dart"
click node_motivation "https://github.com/issey-wu/6onsix/blob/main/lib/core/domain/motivation.dart"
click node_progress "https://github.com/issey-wu/6onsix/blob/main/lib/core/domain/progress.dart"
click node_contentrepo "https://github.com/issey-wu/6onsix/blob/main/lib/core/data/asset_content_repository.dart"
click node_courseparser "https://github.com/issey-wu/6onsix/blob/main/lib/core/data/course_parser.dart"
click node_courseasset "https://github.com/issey-wu/6onsix/blob/main/assets/content/course.json"
click node_database "https://github.com/issey-wu/6onsix/blob/main/lib/core/data/database.dart"
click node_progressrepo "https://github.com/issey-wu/6onsix/blob/main/lib/core/data/drift_progress_repository.dart"
click node_glossary "https://github.com/issey-wu/6onsix/blob/main/lib/features/glossary/presentation/glossary_screen.dart"
click node_avatar "https://github.com/issey-wu/6onsix/blob/main/lib/features/avatar/presentation/avatar_screen.dart"
click node_goal "https://github.com/issey-wu/6onsix/blob/main/lib/features/goal/presentation/goal_screen.dart"
click node_quests "https://github.com/issey-wu/6onsix/blob/main/lib/features/quests/presentation/quests_screen.dart"
click node_profile "https://github.com/issey-wu/6onsix/blob/main/lib/features/profile/presentation/profile_screen.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_app,node_bootstrap,node_router toneBlue
class node_home,node_lesson,node_dragdrop,node_matching,node_lessonfeedback toneAmber
class node_course,node_rules,node_session,node_motivation,node_progress toneMint
class node_contentrepo,node_courseparser,node_courseasset,node_database,node_progressrepo toneRose
class node_glossary,node_avatar,node_goal,node_quests,node_profile,node_learner toneIndigo
```

## Components

### App shell

- [Flutter app](https://github.com/issey-wu/6onsix/blob/main/lib/app/app.dart): `lib/app/app.dart`
- [App bootstrap](https://github.com/issey-wu/6onsix/blob/main/lib/app/bootstrap.dart): `lib/app/bootstrap.dart`
- [Navigation](https://github.com/issey-wu/6onsix/blob/main/lib/app/router.dart): `lib/app/router.dart`

### Learning experience

- [Learning path](https://github.com/issey-wu/6onsix/blob/main/lib/features/learning_path/presentation/home_screen.dart): `lib/features/learning_path/presentation/home_screen.dart`
- [Lesson activities](https://github.com/issey-wu/6onsix/blob/main/lib/features/lesson/presentation/lesson_screen.dart): `lib/features/lesson/presentation/lesson_screen.dart`
- [Drag and drop](https://github.com/issey-wu/6onsix/blob/main/lib/features/lesson/presentation/drag_drop_view.dart): `lib/features/lesson/presentation/drag_drop_view.dart`
- [Matching activity](https://github.com/issey-wu/6onsix/blob/main/lib/features/lesson/presentation/matching_view.dart): `lib/features/lesson/presentation/matching_view.dart`
- [Lesson feedback](https://github.com/issey-wu/6onsix/blob/main/lib/app/feedback.dart): `lib/app/feedback.dart`

### Shared domain

- [Course model](https://github.com/issey-wu/6onsix/blob/main/lib/core/domain/course.dart): `lib/core/domain/course.dart`
- [Game rules](https://github.com/issey-wu/6onsix/blob/main/lib/core/domain/game_rules.dart): `lib/core/domain/game_rules.dart`
- [Lesson session](https://github.com/issey-wu/6onsix/blob/main/lib/core/domain/lesson_session.dart): `lib/core/domain/lesson_session.dart`
- [Motivation and streaks](https://github.com/issey-wu/6onsix/blob/main/lib/core/domain/motivation.dart): `lib/core/domain/motivation.dart`
- [Progress state](https://github.com/issey-wu/6onsix/blob/main/lib/core/domain/progress.dart): `lib/core/domain/progress.dart`

### Offline data

- [Asset content repository](https://github.com/issey-wu/6onsix/blob/main/lib/core/data/asset_content_repository.dart): `lib/core/data/asset_content_repository.dart`
- [Course parser](https://github.com/issey-wu/6onsix/blob/main/lib/core/data/course_parser.dart): `lib/core/data/course_parser.dart`
- [Course content](https://github.com/issey-wu/6onsix/blob/main/assets/content/course.json): `assets/content/course.json`
- [Local database](https://github.com/issey-wu/6onsix/blob/main/lib/core/data/database.dart): `lib/core/data/database.dart`
- [Progress repository](https://github.com/issey-wu/6onsix/blob/main/lib/core/data/drift_progress_repository.dart): `lib/core/data/drift_progress_repository.dart`

### Learner features

- [Glossary](https://github.com/issey-wu/6onsix/blob/main/lib/features/glossary/presentation/glossary_screen.dart): `lib/features/glossary/presentation/glossary_screen.dart`
- [Avatar](https://github.com/issey-wu/6onsix/blob/main/lib/features/avatar/presentation/avatar_screen.dart): `lib/features/avatar/presentation/avatar_screen.dart`
- [Goal setting](https://github.com/issey-wu/6onsix/blob/main/lib/features/goal/presentation/goal_screen.dart): `lib/features/goal/presentation/goal_screen.dart`
- [Quests](https://github.com/issey-wu/6onsix/blob/main/lib/features/quests/presentation/quests_screen.dart): `lib/features/quests/presentation/quests_screen.dart`
- [Profile and settings](https://github.com/issey-wu/6onsix/blob/main/lib/features/profile/presentation/profile_screen.dart): `lib/features/profile/presentation/profile_screen.dart`

### Other components

- **Learner**

## Connections

- Learner → Flutter app: uses (evidence: `README.md`)
- Flutter app → App bootstrap: starts
- Flutter app → Navigation: navigates via
- Learner → Learning path: learns through (evidence: `README.md`)
- Learning path → Lesson activities: opens lessons
- Lesson activities → Drag and drop: presents activity
- Lesson activities → Matching activity: presents activity
- Lesson activities → Lesson feedback: shows feedback (evidence: `README.md`)
- Lesson activities → Lesson session: uses session
- Lesson activities → Game rules: applies rules
- Learning path → Course model: shows course
- Asset content repository → Course content: loads content
- Asset content repository → Course parser: parses content
- Lesson activities → Progress repository: records progress
- Progress repository → Local database: persists progress
- Progress repository → Progress state: stores state
- Learning path → Progress state: shows progression (evidence: `README.md`)
- Progress state → Motivation and streaks: supports streaks
- Learner → Glossary: looks up terms (evidence: `README.md`)
- Learner → Avatar: customizes avatar
- Learner → Goal setting: sets goals
- Learner → Quests: reviews quests
- Learner → Profile and settings: manages profile
