# jiebozhang/mylazyenglish architecture

> Architecture diagram of the GitHub repository jiebozhang/mylazyenglish, 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/jiebozhang/mylazyenglish
- Repository: https://github.com/jiebozhang/mylazyenglish

## Overview

MyLazyEnglish is a child-focused English-learning frontend prototype with a parent console. Its visible workflow is navigating among the home, video library, immersive player, vocabulary review, and progress/profile screens; the player-related components also support subtitle context and adding words to vocabulary. The sampled app routes establish page dispatch, but most page internals were not excerpted, and the README provides no further architecture detail. The API client is configured for /api, though no sampled page shows it being used.

Main entry points: [`frontend/src/App.tsx`](https://github.com/jiebozhang/mylazyenglish/blob/main/frontend/src/App.tsx) (App Shell), [`frontend/src/pages/VocabularyPage.tsx`](https://github.com/jiebozhang/mylazyenglish/blob/main/frontend/src/pages/VocabularyPage.tsx) (Vocabulary Review), [`frontend/src/components/lazyeng/ContextDictionarySheet.tsx`](https://github.com/jiebozhang/mylazyenglish/blob/main/frontend/src/components/lazyeng/ContextDictionarySheet.tsx) (Word Context Sheet), [`frontend/src/data/mock.ts`](https://github.com/jiebozhang/mylazyenglish/blob/main/frontend/src/data/mock.ts) (Prototype Learning Data)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_navigation["App Navigation"]
  node_app["App Shell<br/>[App.tsx]"]
  node_animated["Animated Routes<br/>[AnimatedRoutes.tsx]"]
  node_frame["Device Frame<br/>[DeviceFrame.tsx]"]
  node_bottomnav["Bottom Navigation<br/>[BottomNav.tsx]"]
end

subgraph group_learning["Learning Experience"]
  node_home["Home<br/>[HomePage.tsx]"]
  node_library["Video Library<br/>[LibraryPage.tsx]"]
  node_player["Learning Player<br/>[PlayerPage.tsx]"]
  node_context["Word Context Sheet"]
  node_subtitles["Subtitle View<br/>[SubtitleView.tsx]"]
  node_artwork["Video Artwork<br/>[VideoArtwork.tsx]"]
end

subgraph group_practice["Review And Progress"]
  node_vocabulary["Vocabulary Review<br/>[VocabularyPage.tsx]"]
  node_profile["Learning Progress<br/>[MePage.tsx]"]
  node_parent["Parent Console"]
end

subgraph group_shared["Shared Services"]
  node_mockdata[("Prototype Learning Data<br/>[mock.ts]")]
  node_playerhook["Player State Hook<br/>[use-player.ts]"]
  node_api["API Client<br/>[api-client.ts]"]
  node_motion["Motion Primitives"]
end

node_learner(("Learner"))
node_service{{"Backend API"}}

node_learner -.->|"opens"| node_app
node_app -->|"routes through"| node_animated
node_app -->|"wraps in"| node_frame
node_app -->|"shows navigation"| node_bottomnav
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_library
node_app -->|"routes to"| node_player
node_app -->|"routes to"| node_vocabulary
node_app -->|"routes to"| node_profile
node_app -->|"routes to"| node_parent
node_app -.->|"transitions pages"| node_motion
node_context -->|"reads entries"| node_mockdata
node_context -.->|"offers add-word callback"| node_vocabulary
node_vocabulary -->|"reads vocabulary items"| node_mockdata
node_api -->|"sends API requests"| node_service

click node_app "https://github.com/jiebozhang/mylazyenglish/blob/main/frontend/src/App.tsx"
click node_animated "https://github.com/jiebozhang/mylazyenglish/blob/main/frontend/src/components/AnimatedRoutes.tsx"
click node_frame "https://github.com/jiebozhang/mylazyenglish/blob/main/frontend/src/components/lazyeng/DeviceFrame.tsx"
click node_bottomnav "https://github.com/jiebozhang/mylazyenglish/blob/main/frontend/src/components/lazyeng/BottomNav.tsx"
click node_home "https://github.com/jiebozhang/mylazyenglish/blob/main/frontend/src/pages/HomePage.tsx"
click node_library "https://github.com/jiebozhang/mylazyenglish/blob/main/frontend/src/pages/LibraryPage.tsx"
click node_player "https://github.com/jiebozhang/mylazyenglish/blob/main/frontend/src/pages/PlayerPage.tsx"
click node_context "https://github.com/jiebozhang/mylazyenglish/blob/main/frontend/src/components/lazyeng/ContextDictionarySheet.tsx"
click node_subtitles "https://github.com/jiebozhang/mylazyenglish/blob/main/frontend/src/components/lazyeng/SubtitleView.tsx"
click node_artwork "https://github.com/jiebozhang/mylazyenglish/blob/main/frontend/src/components/lazyeng/VideoArtwork.tsx"
click node_vocabulary "https://github.com/jiebozhang/mylazyenglish/blob/main/frontend/src/pages/VocabularyPage.tsx"
click node_profile "https://github.com/jiebozhang/mylazyenglish/blob/main/frontend/src/pages/MePage.tsx"
click node_parent "https://github.com/jiebozhang/mylazyenglish/blob/main/frontend/src/pages/ParentConsolePage.tsx"
click node_mockdata "https://github.com/jiebozhang/mylazyenglish/blob/main/frontend/src/data/mock.ts"
click node_playerhook "https://github.com/jiebozhang/mylazyenglish/blob/main/frontend/src/hooks/use-player.ts"
click node_api "https://github.com/jiebozhang/mylazyenglish/blob/main/frontend/src/lib/api-client.ts"
click node_motion "https://github.com/jiebozhang/mylazyenglish/blob/main/frontend/src/components/MotionPrimitives.tsx"

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_animated,node_frame,node_bottomnav toneBlue
class node_home,node_library,node_player,node_context,node_subtitles,node_artwork toneAmber
class node_vocabulary,node_profile,node_parent,node_service toneMint
class node_mockdata,node_playerhook,node_api,node_motion toneRose
class node_learner toneIndigo
```

## Components

### App Navigation

- [App Shell](https://github.com/jiebozhang/mylazyenglish/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Animated Routes](https://github.com/jiebozhang/mylazyenglish/blob/main/frontend/src/components/AnimatedRoutes.tsx): `frontend/src/components/AnimatedRoutes.tsx`
- [Device Frame](https://github.com/jiebozhang/mylazyenglish/blob/main/frontend/src/components/lazyeng/DeviceFrame.tsx): `frontend/src/components/lazyeng/DeviceFrame.tsx`
- [Bottom Navigation](https://github.com/jiebozhang/mylazyenglish/blob/main/frontend/src/components/lazyeng/BottomNav.tsx): `frontend/src/components/lazyeng/BottomNav.tsx`

### Learning Experience

- [Home](https://github.com/jiebozhang/mylazyenglish/blob/main/frontend/src/pages/HomePage.tsx): `frontend/src/pages/HomePage.tsx`
- [Video Library](https://github.com/jiebozhang/mylazyenglish/blob/main/frontend/src/pages/LibraryPage.tsx): `frontend/src/pages/LibraryPage.tsx`
- [Learning Player](https://github.com/jiebozhang/mylazyenglish/blob/main/frontend/src/pages/PlayerPage.tsx): `frontend/src/pages/PlayerPage.tsx`
- [Word Context Sheet](https://github.com/jiebozhang/mylazyenglish/blob/main/frontend/src/components/lazyeng/ContextDictionarySheet.tsx): `frontend/src/components/lazyeng/ContextDictionarySheet.tsx`
- [Subtitle View](https://github.com/jiebozhang/mylazyenglish/blob/main/frontend/src/components/lazyeng/SubtitleView.tsx): `frontend/src/components/lazyeng/SubtitleView.tsx`
- [Video Artwork](https://github.com/jiebozhang/mylazyenglish/blob/main/frontend/src/components/lazyeng/VideoArtwork.tsx): `frontend/src/components/lazyeng/VideoArtwork.tsx`

### Review And Progress

- [Vocabulary Review](https://github.com/jiebozhang/mylazyenglish/blob/main/frontend/src/pages/VocabularyPage.tsx): `frontend/src/pages/VocabularyPage.tsx`
- [Learning Progress](https://github.com/jiebozhang/mylazyenglish/blob/main/frontend/src/pages/MePage.tsx): `frontend/src/pages/MePage.tsx`
- [Parent Console](https://github.com/jiebozhang/mylazyenglish/blob/main/frontend/src/pages/ParentConsolePage.tsx): `frontend/src/pages/ParentConsolePage.tsx`

### Shared Services

- [Prototype Learning Data](https://github.com/jiebozhang/mylazyenglish/blob/main/frontend/src/data/mock.ts): `frontend/src/data/mock.ts`
- [Player State Hook](https://github.com/jiebozhang/mylazyenglish/blob/main/frontend/src/hooks/use-player.ts): `frontend/src/hooks/use-player.ts`
- [API Client](https://github.com/jiebozhang/mylazyenglish/blob/main/frontend/src/lib/api-client.ts): `frontend/src/lib/api-client.ts`
- [Motion Primitives](https://github.com/jiebozhang/mylazyenglish/blob/main/frontend/src/components/MotionPrimitives.tsx): `frontend/src/components/MotionPrimitives.tsx`

### Other components

- **Learner**
- **Backend API**

## Connections

- Learner → App Shell: opens
- App Shell → Animated Routes: routes through (evidence: `frontend/src/App.tsx`)
- App Shell → Device Frame: wraps in (evidence: `frontend/src/App.tsx`)
- App Shell → Bottom Navigation: shows navigation (evidence: `frontend/src/App.tsx`)
- App Shell → Home: routes to (evidence: `frontend/src/App.tsx`)
- App Shell → Video Library: routes to (evidence: `frontend/src/App.tsx`)
- App Shell → Learning Player: routes to (evidence: `frontend/src/App.tsx`)
- App Shell → Vocabulary Review: routes to (evidence: `frontend/src/App.tsx`)
- App Shell → Learning Progress: routes to (evidence: `frontend/src/App.tsx`)
- App Shell → Parent Console: routes to (evidence: `frontend/src/App.tsx`)
- App Shell → Motion Primitives: transitions pages
- Word Context Sheet → Prototype Learning Data: reads entries (evidence: `frontend/src/components/lazyeng/ContextDictionarySheet.tsx`)
- Word Context Sheet → Vocabulary Review: offers add-word callback
- Vocabulary Review → Prototype Learning Data: reads vocabulary items (evidence: `frontend/src/pages/VocabularyPage.tsx`)
- API Client → Backend API: sends API requests (evidence: `frontend/src/lib/api-client.ts`)
