# saimsm/studysphere-mobile-application- architecture

> Architecture diagram of the GitHub repository saimsm/studysphere-mobile-application-, 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/saimsm/studysphere-mobile-application-
- Repository: https://github.com/saimsm/studysphere-mobile-application-

## Overview

StudySphere is an Expo/React Native study organizer. Users open the app and navigate to assignment, goal, timetable, and progress screens; the sampled screens call feature services, while app context loads assignment and goal data for shared state. Assignment and goal services persist data in AsyncStorage; timetable persistence helpers are present, but the sampled evidence does not establish how the timetable screen or service uses them. The map includes the shared theme layer; some links rely on source-index references rather than inspected call bodies.

Main entry points: [`src/services/assignmentsApi.ts`](https://github.com/saimsm/studysphere-mobile-application-/blob/master/src/services/assignmentsApi.ts) (Assignments service), [`hooks/use-theme-color.ts`](https://github.com/saimsm/studysphere-mobile-application-/blob/master/hooks/use-theme-color.ts) (Theme hook), [`src/context/AppContext.tsx`](https://github.com/saimsm/studysphere-mobile-application-/blob/master/src/context/AppContext.tsx) (App context), [`src/services/goalsApi.ts`](https://github.com/saimsm/studysphere-mobile-application-/blob/master/src/services/goalsApi.ts) (Goals service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_navigation["App navigation"]
  node_app_shell["App shell<br/>[_layout.tsx]"]
  node_tab_navigation["Tab navigation<br/>[_layout.tsx]"]
end

subgraph group_features["Study workflows"]
  node_assignments_screen["Assignments screen<br/>[assignments.tsx]"]
  node_goals_screen["Goals screen<br/>[goals.tsx]"]
  node_timetable_screen["Timetable screen<br/>[timetable.tsx]"]
  node_progress_screen["Progress screen<br/>[progress.tsx]"]
end

subgraph group_data["State and persistence"]
  node_app_context["App context<br/>[AppContext.tsx]"]
  node_assignments_service["Assignments service<br/>[assignmentsApi.ts]"]
  node_goals_service["Goals service<br/>[goalsApi.ts]"]
  node_progress_service["Progress service<br/>[progressApi.ts]"]
  node_timetable_service["Timetable service<br/>[timetableApi.ts]"]
  node_timetable_storage["Timetable storage"]
  node_timetable_types["Timetable types<br/>[timetable.ts]"]
end

subgraph group_presentation["Shared presentation"]
  node_themed_text["Themed text<br/>[themed-text.tsx]"]
  node_themed_view["Themed view<br/>[themed-view.tsx]"]
  node_theme_hook["Theme hook<br/>[use-theme-color.ts]"]
  node_theme_colors["Theme colors<br/>[theme.ts]"]
  node_color_scheme["Color scheme"]
  node_icon_symbol["Icon symbols<br/>[icon-symbol.tsx]"]
end

node_user(("User"))
node_async_storage[("AsyncStorage")]

node_user -.->|"opens"| node_app_shell
node_app_shell -->|"provides"| node_app_context
node_user -.->|"navigates"| node_tab_navigation
node_assignments_screen -->|"loads and updates"| node_assignments_service
node_goals_screen -->|"loads and updates"| node_goals_service
node_timetable_screen -->|"uses"| node_timetable_service
node_progress_screen -->|"reads"| node_assignments_service
node_app_context -->|"loads"| node_assignments_service
node_app_context -->|"loads"| node_goals_service
node_assignments_service -->|"reads and writes"| node_async_storage
node_goals_service -->|"reads and writes"| node_async_storage
node_progress_service -->|"references"| node_assignments_service
node_timetable_storage -->|"reads and writes"| node_async_storage
node_timetable_storage -->|"uses"| node_timetable_types
node_themed_text -->|"gets color"| node_theme_hook
node_themed_view -->|"gets color"| node_theme_hook
node_theme_hook -->|"selects colors"| node_theme_colors
node_theme_hook -->|"reads scheme"| node_color_scheme

click node_app_shell "https://github.com/saimsm/studysphere-mobile-application-/blob/master/app/_layout.tsx"
click node_tab_navigation "https://github.com/saimsm/studysphere-mobile-application-/blob/master/app/(drawer)/(tabs)/_layout.tsx"
click node_assignments_screen "https://github.com/saimsm/studysphere-mobile-application-/blob/master/app/(drawer)/(tabs)/assignments.tsx"
click node_goals_screen "https://github.com/saimsm/studysphere-mobile-application-/blob/master/app/(drawer)/(tabs)/goals.tsx"
click node_timetable_screen "https://github.com/saimsm/studysphere-mobile-application-/blob/master/app/(drawer)/(tabs)/timetable.tsx"
click node_progress_screen "https://github.com/saimsm/studysphere-mobile-application-/blob/master/app/(drawer)/progress.tsx"
click node_app_context "https://github.com/saimsm/studysphere-mobile-application-/blob/master/src/context/AppContext.tsx"
click node_assignments_service "https://github.com/saimsm/studysphere-mobile-application-/blob/master/src/services/assignmentsApi.ts"
click node_goals_service "https://github.com/saimsm/studysphere-mobile-application-/blob/master/src/services/goalsApi.ts"
click node_progress_service "https://github.com/saimsm/studysphere-mobile-application-/blob/master/src/services/progressApi.ts"
click node_timetable_service "https://github.com/saimsm/studysphere-mobile-application-/blob/master/src/services/timetableApi.ts"
click node_timetable_storage "https://github.com/saimsm/studysphere-mobile-application-/blob/master/storage/timetableStorage.ts"
click node_timetable_types "https://github.com/saimsm/studysphere-mobile-application-/blob/master/types/timetable.ts"
click node_themed_text "https://github.com/saimsm/studysphere-mobile-application-/blob/master/components/themed-text.tsx"
click node_themed_view "https://github.com/saimsm/studysphere-mobile-application-/blob/master/components/themed-view.tsx"
click node_theme_hook "https://github.com/saimsm/studysphere-mobile-application-/blob/master/hooks/use-theme-color.ts"
click node_theme_colors "https://github.com/saimsm/studysphere-mobile-application-/blob/master/constants/theme.ts"
click node_color_scheme "https://github.com/saimsm/studysphere-mobile-application-/blob/master/hooks/use-color-scheme.ts"
click node_icon_symbol "https://github.com/saimsm/studysphere-mobile-application-/blob/master/components/ui/icon-symbol.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_shell,node_tab_navigation,node_user toneBlue
class node_assignments_screen,node_goals_screen,node_timetable_screen,node_progress_screen,node_async_storage toneAmber
class node_app_context,node_assignments_service,node_goals_service,node_progress_service,node_timetable_service,node_timetable_storage,node_timetable_types toneMint
class node_themed_text,node_themed_view,node_theme_hook,node_theme_colors,node_color_scheme,node_icon_symbol toneRose
```

## Components

### App navigation

- [App shell](https://github.com/saimsm/studysphere-mobile-application-/blob/master/app/_layout.tsx): `app/_layout.tsx`
- [Tab navigation](https://github.com/saimsm/studysphere-mobile-application-/blob/master/app/(drawer)/(tabs)/_layout.tsx): `app/(drawer)/(tabs)/_layout.tsx`

### Study workflows

- [Assignments screen](https://github.com/saimsm/studysphere-mobile-application-/blob/master/app/(drawer)/(tabs)/assignments.tsx): `app/(drawer)/(tabs)/assignments.tsx`
- [Goals screen](https://github.com/saimsm/studysphere-mobile-application-/blob/master/app/(drawer)/(tabs)/goals.tsx): `app/(drawer)/(tabs)/goals.tsx`
- [Timetable screen](https://github.com/saimsm/studysphere-mobile-application-/blob/master/app/(drawer)/(tabs)/timetable.tsx): `app/(drawer)/(tabs)/timetable.tsx`
- [Progress screen](https://github.com/saimsm/studysphere-mobile-application-/blob/master/app/(drawer)/progress.tsx): `app/(drawer)/progress.tsx`

### State and persistence

- [App context](https://github.com/saimsm/studysphere-mobile-application-/blob/master/src/context/AppContext.tsx): `src/context/AppContext.tsx`
- [Assignments service](https://github.com/saimsm/studysphere-mobile-application-/blob/master/src/services/assignmentsApi.ts): `src/services/assignmentsApi.ts`
- [Goals service](https://github.com/saimsm/studysphere-mobile-application-/blob/master/src/services/goalsApi.ts): `src/services/goalsApi.ts`
- [Progress service](https://github.com/saimsm/studysphere-mobile-application-/blob/master/src/services/progressApi.ts): `src/services/progressApi.ts`
- [Timetable service](https://github.com/saimsm/studysphere-mobile-application-/blob/master/src/services/timetableApi.ts): `src/services/timetableApi.ts`
- [Timetable storage](https://github.com/saimsm/studysphere-mobile-application-/blob/master/storage/timetableStorage.ts): `storage/timetableStorage.ts`
- [Timetable types](https://github.com/saimsm/studysphere-mobile-application-/blob/master/types/timetable.ts): `types/timetable.ts`

### Shared presentation

- [Themed text](https://github.com/saimsm/studysphere-mobile-application-/blob/master/components/themed-text.tsx): `components/themed-text.tsx`
- [Themed view](https://github.com/saimsm/studysphere-mobile-application-/blob/master/components/themed-view.tsx): `components/themed-view.tsx`
- [Theme hook](https://github.com/saimsm/studysphere-mobile-application-/blob/master/hooks/use-theme-color.ts): `hooks/use-theme-color.ts`
- [Theme colors](https://github.com/saimsm/studysphere-mobile-application-/blob/master/constants/theme.ts): `constants/theme.ts`
- [Color scheme](https://github.com/saimsm/studysphere-mobile-application-/blob/master/hooks/use-color-scheme.ts): `hooks/use-color-scheme.ts`
- [Icon symbols](https://github.com/saimsm/studysphere-mobile-application-/blob/master/components/ui/icon-symbol.tsx): `components/ui/icon-symbol.tsx`

### Other components

- **User**
- **AsyncStorage**

## Connections

- User → App shell: opens (evidence: `README.md`)
- App shell → App context: provides (evidence: `app/_layout.tsx`)
- User → Tab navigation: navigates (evidence: `README.md`)
- Assignments screen → Assignments service: loads and updates (evidence: `app/(drawer)/(tabs)/assignments.tsx`)
- Goals screen → Goals service: loads and updates (evidence: `app/(drawer)/(tabs)/goals.tsx`)
- Timetable screen → Timetable service: uses (evidence: `app/(drawer)/(tabs)/timetable.tsx`)
- Progress screen → Assignments service: reads (evidence: `app/(drawer)/progress.tsx`)
- App context → Assignments service: loads (evidence: `src/context/AppContext.tsx`)
- App context → Goals service: loads (evidence: `src/context/AppContext.tsx`)
- Assignments service → AsyncStorage: reads and writes (evidence: `src/services/assignmentsApi.ts`)
- Goals service → AsyncStorage: reads and writes (evidence: `src/services/goalsApi.ts`)
- Progress service → Assignments service: references (evidence: `src/services/progressApi.ts`)
- Timetable storage → AsyncStorage: reads and writes (evidence: `storage/timetableStorage.ts`)
- Timetable storage → Timetable types: uses (evidence: `storage/timetableStorage.ts`)
- Themed text → Theme hook: gets color (evidence: `components/themed-text.tsx`)
- Themed view → Theme hook: gets color (evidence: `components/themed-view.tsx`)
- Theme hook → Theme colors: selects colors (evidence: `hooks/use-theme-color.ts`)
- Theme hook → Color scheme: reads scheme (evidence: `hooks/use-theme-color.ts`)
