# luciferiswebdevelopper/study_tracker architecture

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

- Interactive diagram: https://gitdiagram.com/luciferiswebdevelopper/study_tracker
- Repository: https://github.com/luciferiswebdevelopper/study_tracker

## Overview

Study Tracker is a mobile learning-planner app: users paste structured study content, generate sectioned tasks, complete them, and track activity and streaks. The main tab screen owns task generation, completion, calendar views, and progress state; it delegates parsing and persistence to utility modules. A separate App.jsx implements a simpler task-and-points version. The README documents streak tracking and folder/task extraction; sampled code also shows calendar, achievements, and sound. The gamification utility is included, but its use is not established by the available evidence.

Main entry points: [`study-tracker/app/(tabs)/index.tsx`](https://github.com/luciferiswebdevelopper/study_tracker/blob/main/study-tracker/app/(tabs)/index.tsx) (Study dashboard), [`study-tracker/app/_layout.tsx`](https://github.com/luciferiswebdevelopper/study_tracker/blob/main/study-tracker/app/_layout.tsx) (Root navigation), [`study-tracker/utils/parser.js`](https://github.com/luciferiswebdevelopper/study_tracker/blob/main/study-tracker/utils/parser.js) (Content parser), [`study-tracker/utils/storage.js`](https://github.com/luciferiswebdevelopper/study_tracker/blob/main/study-tracker/utils/storage.js) (Local persistence)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Study workflow"]
  node_study_screen["Study dashboard<br/>[index.tsx]"]
  node_task_data["Study progress<br/>[index.tsx]"]
  node_simple_tracker["Simple tracker<br/>[App.jsx]"]
end

subgraph group_services["App services"]
  node_task_parser["Content parser<br/>[parser.js]"]
  node_local_storage[("Local persistence<br/>[storage.js]")]
  node_gamification["Gamification helpers<br/>[gamification.ts]"]
end

subgraph group_navigation["App navigation"]
  node_root_layout["Root navigation<br/>[_layout.tsx]"]
  node_tabs_layout["Tab navigation<br/>[_layout.tsx]"]
end

node_learner(("Learner"))

node_learner -->|"uses"| node_study_screen
node_study_screen -->|"parses input"| node_task_parser
node_study_screen -->|"generates and updates"| node_task_data
node_study_screen -->|"loads and saves"| node_local_storage
node_root_layout -->|"routes to"| node_tabs_layout

click node_study_screen "https://github.com/luciferiswebdevelopper/study_tracker/blob/main/study-tracker/app/(tabs)/index.tsx"
click node_task_parser "https://github.com/luciferiswebdevelopper/study_tracker/blob/main/study-tracker/utils/parser.js"
click node_task_data "https://github.com/luciferiswebdevelopper/study_tracker/blob/main/study-tracker/app/(tabs)/index.tsx"
click node_local_storage "https://github.com/luciferiswebdevelopper/study_tracker/blob/main/study-tracker/utils/storage.js"
click node_gamification "https://github.com/luciferiswebdevelopper/study_tracker/blob/main/study-tracker/utils/gamification.ts"
click node_root_layout "https://github.com/luciferiswebdevelopper/study_tracker/blob/main/study-tracker/app/_layout.tsx"
click node_tabs_layout "https://github.com/luciferiswebdevelopper/study_tracker/blob/main/study-tracker/app/(tabs)/_layout.tsx"
click node_simple_tracker "https://github.com/luciferiswebdevelopper/study_tracker/blob/main/study-tracker/App.jsx"

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_study_screen,node_task_data,node_simple_tracker toneBlue
class node_task_parser,node_local_storage,node_gamification toneAmber
class node_root_layout,node_tabs_layout toneMint
class node_learner toneIndigo
```

## Components

### Study workflow

- [Study dashboard](https://github.com/luciferiswebdevelopper/study_tracker/blob/main/study-tracker/app/(tabs)/index.tsx): `study-tracker/app/(tabs)/index.tsx`
- [Study progress](https://github.com/luciferiswebdevelopper/study_tracker/blob/main/study-tracker/app/(tabs)/index.tsx): `study-tracker/app/(tabs)/index.tsx`
- [Simple tracker](https://github.com/luciferiswebdevelopper/study_tracker/blob/main/study-tracker/App.jsx): `study-tracker/App.jsx`

### App services

- [Content parser](https://github.com/luciferiswebdevelopper/study_tracker/blob/main/study-tracker/utils/parser.js): `study-tracker/utils/parser.js`
- [Local persistence](https://github.com/luciferiswebdevelopper/study_tracker/blob/main/study-tracker/utils/storage.js): `study-tracker/utils/storage.js`
- [Gamification helpers](https://github.com/luciferiswebdevelopper/study_tracker/blob/main/study-tracker/utils/gamification.ts): `study-tracker/utils/gamification.ts`

### App navigation

- [Root navigation](https://github.com/luciferiswebdevelopper/study_tracker/blob/main/study-tracker/app/_layout.tsx): `study-tracker/app/_layout.tsx`
- [Tab navigation](https://github.com/luciferiswebdevelopper/study_tracker/blob/main/study-tracker/app/(tabs)/_layout.tsx): `study-tracker/app/(tabs)/_layout.tsx`

### Other components

- **Learner**

## Connections

- Learner → Study dashboard: uses (evidence: `README.md`)
- Study dashboard → Content parser: parses input (evidence: `study-tracker/app/(tabs)/index.tsx`)
- Study dashboard → Study progress: generates and updates (evidence: `study-tracker/app/(tabs)/index.tsx`)
- Study dashboard → Local persistence: loads and saves (evidence: `study-tracker/app/(tabs)/index.tsx`)
- Root navigation → Tab navigation: routes to (evidence: `study-tracker/app/_layout.tsx`)
