# rob180893/meu-app architecture

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

- Interactive diagram: https://gitdiagram.com/rob180893/meu-app
- Repository: https://github.com/rob180893/meu-app

## Overview

Meu Quadro de Estudos is an offline, single-device study planner: learners organize disciplines and topics, record study sessions, plan cycles and weeks, then review progress and scheduled revisions. The React app coordinates these views and keeps study and Kanban state in browser storage; backup export/import supports moving data between app copies. The README confirms there is no account or server. Some view internals were not sampled, so only documented or indexed relationships are shown; CompareView is present but its integration is not established by the evidence.

Main entry points: [`src/App.tsx`](https://github.com/rob180893/meu-app/blob/main/src/App.tsx) (App Coordinator), [`src/utils/stats.ts`](https://github.com/rob180893/meu-app/blob/main/src/utils/stats.ts) (Study Statistics), [`src/utils/storage.ts`](https://github.com/rob180893/meu-app/blob/main/src/utils/storage.ts) (Storage and Backup), [`src/utils/reviews.ts`](https://github.com/rob180893/meu-app/blob/main/src/utils/reviews.ts) (Review Scheduling)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App Shell"]
  node_app["App Coordinator<br/>[App.tsx]"]
  node_header["Navigation Header<br/>[Header.tsx]"]
end

subgraph group_study["Study Planning"]
  node_home["Study Home<br/>[HomeView.tsx]"]
  node_disciplines["Disciplines"]
  node_kanban["Kanban Boards<br/>[KanbanView.tsx]"]
  node_cycle["Study Cycles<br/>[CycleView.tsx]"]
  node_weekly["Weekly Plan<br/>[WeeklyPlanView.tsx]"]
  node_register["Study Register"]
  node_focus["Focus Timer<br/>[FocusModal.tsx]"]
end

subgraph group_insight["Reviews and Progress"]
  node_compare["Study Comparison<br/>[CompareView.tsx]"]
  node_reviews["Review Schedule<br/>[ReviewView.tsx]"]
  node_reviewwidget["Due Review Widget"]
  node_reviewlogic["Review Scheduling<br/>[reviews.ts]"]
  node_statsview["Statistics View<br/>[StatsView.tsx]"]
  node_statslogic["Study Statistics<br/>[stats.ts]"]
end

subgraph group_runtime["Local Runtime"]
  node_storage["Storage and Backup<br/>[storage.ts]"]
  node_localdata[("Browser Storage")]
  node_topics["Topic Synchronization<br/>[topics.ts]"]
  node_formatters["Date and Text Helpers<br/>[formatters.ts]"]
  node_pwa["Install Button"]
  node_installhook["PWA Install Hook<br/>[usePWAInstall.ts]"]
end

node_learner(("Learner"))

node_learner -->|"uses"| node_app
node_app -->|"renders"| node_header
node_app -->|"renders"| node_home
node_app -->|"renders"| node_disciplines
node_app -->|"renders"| node_kanban
node_app -->|"renders"| node_cycle
node_app -->|"renders"| node_weekly
node_app -->|"renders"| node_statsview
node_app -->|"renders"| node_reviews
node_app -->|"renders"| node_focus
node_app -->|"renders"| node_register
node_app -->|"renders"| node_reviewwidget
node_app -->|"loads and saves"| node_storage
node_storage -->|"reads and writes"| node_localdata
node_reviews -->|"builds schedule"| node_reviewlogic
node_reviewwidget -->|"builds due list"| node_reviewlogic
node_statsview -->|"calculates metrics"| node_statslogic
node_weekly -->|"uses metrics"| node_statslogic
node_focus -->|"uses metrics"| node_statslogic
node_app -->|"syncs topics"| node_topics
node_storage -->|"uses dates and IDs"| node_formatters
node_reviewlogic -->|"calculates dates"| node_formatters
node_statslogic -->|"formats dates"| node_formatters
node_header -->|"renders"| node_pwa
node_pwa -->|"uses hook"| node_installhook

click node_app "https://github.com/rob180893/meu-app/blob/main/src/App.tsx"
click node_header "https://github.com/rob180893/meu-app/blob/main/src/components/Header.tsx"
click node_home "https://github.com/rob180893/meu-app/blob/main/src/components/HomeView.tsx"
click node_disciplines "https://github.com/rob180893/meu-app/blob/main/src/components/DisciplinesView.tsx"
click node_kanban "https://github.com/rob180893/meu-app/blob/main/src/components/KanbanView.tsx"
click node_cycle "https://github.com/rob180893/meu-app/blob/main/src/components/CycleView.tsx"
click node_weekly "https://github.com/rob180893/meu-app/blob/main/src/components/WeeklyPlanView.tsx"
click node_register "https://github.com/rob180893/meu-app/blob/main/src/components/StudyRegisterModal.tsx"
click node_focus "https://github.com/rob180893/meu-app/blob/main/src/components/FocusModal.tsx"
click node_compare "https://github.com/rob180893/meu-app/blob/main/src/components/CompareView.tsx"
click node_reviews "https://github.com/rob180893/meu-app/blob/main/src/components/ReviewView.tsx"
click node_reviewwidget "https://github.com/rob180893/meu-app/blob/main/src/components/FloatingReviewsWidget.tsx"
click node_reviewlogic "https://github.com/rob180893/meu-app/blob/main/src/utils/reviews.ts"
click node_statsview "https://github.com/rob180893/meu-app/blob/main/src/components/StatsView.tsx"
click node_statslogic "https://github.com/rob180893/meu-app/blob/main/src/utils/stats.ts"
click node_storage "https://github.com/rob180893/meu-app/blob/main/src/utils/storage.ts"
click node_topics "https://github.com/rob180893/meu-app/blob/main/src/utils/topics.ts"
click node_formatters "https://github.com/rob180893/meu-app/blob/main/src/utils/formatters.ts"
click node_pwa "https://github.com/rob180893/meu-app/blob/main/src/components/PWAInstallButton.tsx"
click node_installhook "https://github.com/rob180893/meu-app/blob/main/src/hooks/usePWAInstall.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_app,node_header toneBlue
class node_home,node_disciplines,node_kanban,node_cycle,node_weekly,node_register,node_focus toneAmber
class node_compare,node_reviews,node_reviewwidget,node_reviewlogic,node_statsview,node_statslogic toneMint
class node_storage,node_localdata,node_topics,node_formatters,node_pwa,node_installhook toneRose
class node_learner toneIndigo
```

## Components

### App Shell

- [App Coordinator](https://github.com/rob180893/meu-app/blob/main/src/App.tsx): `src/App.tsx`
- [Navigation Header](https://github.com/rob180893/meu-app/blob/main/src/components/Header.tsx): `src/components/Header.tsx`

### Study Planning

- [Study Home](https://github.com/rob180893/meu-app/blob/main/src/components/HomeView.tsx): `src/components/HomeView.tsx`
- [Disciplines](https://github.com/rob180893/meu-app/blob/main/src/components/DisciplinesView.tsx): `src/components/DisciplinesView.tsx`
- [Kanban Boards](https://github.com/rob180893/meu-app/blob/main/src/components/KanbanView.tsx): `src/components/KanbanView.tsx`
- [Study Cycles](https://github.com/rob180893/meu-app/blob/main/src/components/CycleView.tsx): `src/components/CycleView.tsx`
- [Weekly Plan](https://github.com/rob180893/meu-app/blob/main/src/components/WeeklyPlanView.tsx): `src/components/WeeklyPlanView.tsx`
- [Study Register](https://github.com/rob180893/meu-app/blob/main/src/components/StudyRegisterModal.tsx): `src/components/StudyRegisterModal.tsx`
- [Focus Timer](https://github.com/rob180893/meu-app/blob/main/src/components/FocusModal.tsx): `src/components/FocusModal.tsx`

### Reviews and Progress

- [Study Comparison](https://github.com/rob180893/meu-app/blob/main/src/components/CompareView.tsx): `src/components/CompareView.tsx`
- [Review Schedule](https://github.com/rob180893/meu-app/blob/main/src/components/ReviewView.tsx): `src/components/ReviewView.tsx`
- [Due Review Widget](https://github.com/rob180893/meu-app/blob/main/src/components/FloatingReviewsWidget.tsx): `src/components/FloatingReviewsWidget.tsx`
- [Review Scheduling](https://github.com/rob180893/meu-app/blob/main/src/utils/reviews.ts): `src/utils/reviews.ts`
- [Statistics View](https://github.com/rob180893/meu-app/blob/main/src/components/StatsView.tsx): `src/components/StatsView.tsx`
- [Study Statistics](https://github.com/rob180893/meu-app/blob/main/src/utils/stats.ts): `src/utils/stats.ts`

### Local Runtime

- [Storage and Backup](https://github.com/rob180893/meu-app/blob/main/src/utils/storage.ts): `src/utils/storage.ts`
- **Browser Storage**
- [Topic Synchronization](https://github.com/rob180893/meu-app/blob/main/src/utils/topics.ts): `src/utils/topics.ts`
- [Date and Text Helpers](https://github.com/rob180893/meu-app/blob/main/src/utils/formatters.ts): `src/utils/formatters.ts`
- [Install Button](https://github.com/rob180893/meu-app/blob/main/src/components/PWAInstallButton.tsx): `src/components/PWAInstallButton.tsx`
- [PWA Install Hook](https://github.com/rob180893/meu-app/blob/main/src/hooks/usePWAInstall.ts): `src/hooks/usePWAInstall.ts`

### Other components

- **Learner**

## Connections

- Learner → App Coordinator: uses (evidence: `README.md`)
- App Coordinator → Navigation Header: renders (evidence: `src/App.tsx`)
- App Coordinator → Study Home: renders (evidence: `src/App.tsx`)
- App Coordinator → Disciplines: renders (evidence: `src/App.tsx`)
- App Coordinator → Kanban Boards: renders (evidence: `src/App.tsx`)
- App Coordinator → Study Cycles: renders (evidence: `src/App.tsx`)
- App Coordinator → Weekly Plan: renders (evidence: `src/App.tsx`)
- App Coordinator → Statistics View: renders (evidence: `src/App.tsx`)
- App Coordinator → Review Schedule: renders (evidence: `src/App.tsx`)
- App Coordinator → Focus Timer: renders (evidence: `src/App.tsx`)
- App Coordinator → Study Register: renders (evidence: `src/App.tsx`)
- App Coordinator → Due Review Widget: renders (evidence: `src/App.tsx`)
- App Coordinator → Storage and Backup: loads and saves (evidence: `src/App.tsx`)
- Storage and Backup → Browser Storage: reads and writes (evidence: `README.md`)
- Review Schedule → Review Scheduling: builds schedule (evidence: `src/components/ReviewView.tsx`)
- Due Review Widget → Review Scheduling: builds due list (evidence: `src/components/FloatingReviewsWidget.tsx`)
- Statistics View → Study Statistics: calculates metrics (evidence: `src/components/StatsView.tsx`)
- Weekly Plan → Study Statistics: uses metrics (evidence: `src/components/WeeklyPlanView.tsx`)
- Focus Timer → Study Statistics: uses metrics (evidence: `src/components/FocusModal.tsx`)
- App Coordinator → Topic Synchronization: syncs topics (evidence: `src/App.tsx`)
- Storage and Backup → Date and Text Helpers: uses dates and IDs (evidence: `src/utils/storage.ts`)
- Review Scheduling → Date and Text Helpers: calculates dates (evidence: `src/utils/reviews.ts`)
- Study Statistics → Date and Text Helpers: formats dates (evidence: `src/utils/stats.ts`)
- Navigation Header → Install Button: renders (evidence: `src/components/Header.tsx`)
- Install Button → PWA Install Hook: uses hook (evidence: `src/components/PWAInstallButton.tsx`)
