# anishkmbtech/sololeveling-themed-to-do-app architecture

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

- Interactive diagram: https://gitdiagram.com/anishkmbtech/sololeveling-themed-to-do-app
- Repository: https://github.com/anishkmbtech/sololeveling-themed-to-do-app

## Overview

System Tracker is a React daily-quest tracker: users register, accept the daily directive, update quests, and view progress, history, and player stats. The app also documents an IGIRIS assistant with OpenRouter chat and voice, plus leveling and penalty mechanics. The excerpts show the app-level component wiring and calendar/quest UI, but not all state-transition or persistence code; uncertain internal flows are therefore omitted. LocalStorage and the OpenRouter request are documented or visible, while other integrations are not inferred.

Main entry points: [`App.tsx`](https://github.com/anishkmbtech/sololeveling-themed-to-do-app/blob/main/App.tsx) (App State and Navigation), [`components/IgirisInterface.tsx`](https://github.com/anishkmbtech/sololeveling-themed-to-do-app/blob/main/components/IgirisInterface.tsx) (IGIRIS Chat and Voice), [`index.tsx`](https://github.com/anishkmbtech/sololeveling-themed-to-do-app/blob/main/index.tsx) (React Entry Point), [`components/Onboarding.tsx`](https://github.com/anishkmbtech/sololeveling-themed-to-do-app/blob/main/components/Onboarding.tsx) (Player Onboarding)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_setup["Player Setup"]
  node_onboarding["Player Onboarding<br/>[Onboarding.tsx]"]
end

subgraph group_gameplay["Quest Gameplay"]
  node_app["App State and Navigation<br/>[App.tsx]"]
  node_models["Game Data Models<br/>[types.ts]"]
  node_defaults["Initial Stats and Quests<br/>[constants.ts]"]
  node_intro["Quest Alert<br/>[IntroAlert.tsx]"]
  node_questcard["Quest Controls<br/>[QuestCard.tsx]"]
  node_levelup["Level-up Overlay<br/>[LevelUpOverlay.tsx]"]
end

subgraph group_progress["Progress and History"]
  node_status["Player Status<br/>[StatusPanel.tsx]"]
  node_calendar["Calendar History<br/>[CalendarView.tsx]"]
  node_localstorage[("Browser LocalStorage")]
end

subgraph group_assistant["IGIRIS Assistant"]
  node_igiris["IGIRIS Chat and Voice"]
  node_openrouter["OpenRouter API"]
  node_speech["Browser Speech APIs"]
end

node_player(("Player"))
node_entry["React Entry Point<br/>[index.tsx]"]

node_player -->|"opens app"| node_entry
node_entry -->|"renders"| node_app
node_app -->|"uses types"| node_models
node_app -->|"initializes from"| node_defaults
node_app -->|"renders"| node_onboarding
node_app -->|"renders"| node_intro
node_app -->|"renders"| node_questcard
node_app -->|"renders"| node_levelup
node_app -->|"passes stats"| node_status
node_app -->|"passes history"| node_calendar
node_app -->|"passes chat settings"| node_igiris
node_app -->|"reads and writes"| node_localstorage
node_player -->|"enters profile"| node_onboarding
node_player -->|"updates quests"| node_questcard
node_player -->|"edits profile"| node_status
node_player -->|"chats and speaks"| node_igiris
node_igiris -->|"requests chat"| node_openrouter
node_igiris -->|"uses recognition"| node_speech
node_igiris -.->|"uses voice output"| node_speech
node_app -.->|"queues level-up"| node_levelup
node_app -->|"supplies daily logs"| node_calendar
node_localstorage -.->|"restores saved state"| node_app

click node_app "https://github.com/anishkmbtech/sololeveling-themed-to-do-app/blob/main/App.tsx"
click node_models "https://github.com/anishkmbtech/sololeveling-themed-to-do-app/blob/main/types.ts"
click node_defaults "https://github.com/anishkmbtech/sololeveling-themed-to-do-app/blob/main/constants.ts"
click node_onboarding "https://github.com/anishkmbtech/sololeveling-themed-to-do-app/blob/main/components/Onboarding.tsx"
click node_intro "https://github.com/anishkmbtech/sololeveling-themed-to-do-app/blob/main/components/IntroAlert.tsx"
click node_questcard "https://github.com/anishkmbtech/sololeveling-themed-to-do-app/blob/main/components/QuestCard.tsx"
click node_levelup "https://github.com/anishkmbtech/sololeveling-themed-to-do-app/blob/main/components/LevelUpOverlay.tsx"
click node_status "https://github.com/anishkmbtech/sololeveling-themed-to-do-app/blob/main/components/StatusPanel.tsx"
click node_calendar "https://github.com/anishkmbtech/sololeveling-themed-to-do-app/blob/main/components/CalendarView.tsx"
click node_igiris "https://github.com/anishkmbtech/sololeveling-themed-to-do-app/blob/main/components/IgirisInterface.tsx"
click node_entry "https://github.com/anishkmbtech/sololeveling-themed-to-do-app/blob/main/index.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_onboarding toneBlue
class node_app,node_models,node_defaults,node_intro,node_questcard,node_levelup toneAmber
class node_status,node_calendar,node_localstorage toneMint
class node_igiris,node_openrouter,node_speech toneRose
class node_player toneIndigo
class node_entry toneTeal
```

## Components

### Player Setup

- [Player Onboarding](https://github.com/anishkmbtech/sololeveling-themed-to-do-app/blob/main/components/Onboarding.tsx): `components/Onboarding.tsx`

### Quest Gameplay

- [App State and Navigation](https://github.com/anishkmbtech/sololeveling-themed-to-do-app/blob/main/App.tsx): `App.tsx`
- [Game Data Models](https://github.com/anishkmbtech/sololeveling-themed-to-do-app/blob/main/types.ts): `types.ts`
- [Initial Stats and Quests](https://github.com/anishkmbtech/sololeveling-themed-to-do-app/blob/main/constants.ts): `constants.ts`
- [Quest Alert](https://github.com/anishkmbtech/sololeveling-themed-to-do-app/blob/main/components/IntroAlert.tsx): `components/IntroAlert.tsx`
- [Quest Controls](https://github.com/anishkmbtech/sololeveling-themed-to-do-app/blob/main/components/QuestCard.tsx): `components/QuestCard.tsx`
- [Level-up Overlay](https://github.com/anishkmbtech/sololeveling-themed-to-do-app/blob/main/components/LevelUpOverlay.tsx): `components/LevelUpOverlay.tsx`

### Progress and History

- [Player Status](https://github.com/anishkmbtech/sololeveling-themed-to-do-app/blob/main/components/StatusPanel.tsx): `components/StatusPanel.tsx`
- [Calendar History](https://github.com/anishkmbtech/sololeveling-themed-to-do-app/blob/main/components/CalendarView.tsx): `components/CalendarView.tsx`
- **Browser LocalStorage**

### IGIRIS Assistant

- [IGIRIS Chat and Voice](https://github.com/anishkmbtech/sololeveling-themed-to-do-app/blob/main/components/IgirisInterface.tsx): `components/IgirisInterface.tsx`
- **OpenRouter API**
- **Browser Speech APIs**

### Other components

- **Player**
- [React Entry Point](https://github.com/anishkmbtech/sololeveling-themed-to-do-app/blob/main/index.tsx): `index.tsx`

## Connections

- Player → React Entry Point: opens app (evidence: `README.md`)
- React Entry Point → App State and Navigation: renders (evidence: `index.tsx`)
- App State and Navigation → Game Data Models: uses types (evidence: `App.tsx`)
- App State and Navigation → Initial Stats and Quests: initializes from (evidence: `constants.ts`)
- App State and Navigation → Player Onboarding: renders (evidence: `App.tsx`)
- App State and Navigation → Quest Alert: renders (evidence: `App.tsx`)
- App State and Navigation → Quest Controls: renders (evidence: `App.tsx`)
- App State and Navigation → Level-up Overlay: renders (evidence: `App.tsx`)
- App State and Navigation → Player Status: passes stats (evidence: `App.tsx`)
- App State and Navigation → Calendar History: passes history (evidence: `App.tsx`)
- App State and Navigation → IGIRIS Chat and Voice: passes chat settings (evidence: `App.tsx`)
- App State and Navigation → Browser LocalStorage: reads and writes (evidence: `App.tsx`)
- Player → Player Onboarding: enters profile (evidence: `components/Onboarding.tsx`)
- Player → Quest Controls: updates quests (evidence: `components/QuestCard.tsx`)
- Player → Player Status: edits profile (evidence: `components/StatusPanel.tsx`)
- Player → IGIRIS Chat and Voice: chats and speaks (evidence: `README.md`)
- IGIRIS Chat and Voice → OpenRouter API: requests chat (evidence: `components/IgirisInterface.tsx`)
- IGIRIS Chat and Voice → Browser Speech APIs: uses recognition (evidence: `components/IgirisInterface.tsx`)
- IGIRIS Chat and Voice → Browser Speech APIs: uses voice output
- App State and Navigation → Level-up Overlay: queues level-up (evidence: `App.tsx`)
- App State and Navigation → Calendar History: supplies daily logs (evidence: `App.tsx`)
- Browser LocalStorage → App State and Navigation: restores saved state
