# gdlion1/studysync architecture

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

- Interactive diagram: https://gitdiagram.com/gdlion1/studysync
- Repository: https://github.com/gdlion1/studysync

## Overview

StudySync helps students discover or create study circles, coordinate study sessions, and collaborate through group chat and shared resources. The principal workflow runs from the routed React app into group discovery or creation, then into a study hub; separate profile, scheduling, and resource pages support that journey. The repository contains a Django API and data models, although the README describes Supabase as the backend; the sampled client API wrapper targets a configurable HTTP backend. Some advertised live and notification capabilities are documented but their full implementations were not sampled.

Main entry points: [`src/main.tsx`](https://github.com/gdlion1/studysync/blob/main/src/main.tsx) (Router and shell), [`src/lib/api.ts`](https://github.com/gdlion1/studysync/blob/main/src/lib/api.ts) (HTTP API client), [`src/pages/Schedule.tsx`](https://github.com/gdlion1/studysync/blob/main/src/pages/Schedule.tsx) (Sessions and focus), [`src/pages/FindGroups.tsx`](https://github.com/gdlion1/studysync/blob/main/src/pages/FindGroups.tsx) (Find circles)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application shell"]
  node_app_entry["Router and shell<br/>[main.tsx]"]
  node_navbar["Navigation<br/>[Navbar.tsx]"]
  node_footer["Footer<br/>[Footer.tsx]"]
  node_home["Home<br/>[Home.tsx]"]
end

subgraph group_circles["Study circles"]
  node_group_search["Find circles<br/>[FindGroups.tsx]"]
  node_group_create["Create circle<br/>[CreateGroup.tsx]"]
  node_study_hub["Study hub<br/>[StudyHub.tsx]"]
end

subgraph group_academics["Academic tools"]
  node_scheduling["Sessions and focus<br/>[Schedule.tsx]"]
  node_resources["Study resources<br/>[Resources.tsx]"]
  node_curriculum["VTU curriculum data<br/>[vtuData.ts]"]
end

subgraph group_identity["Student identity"]
  node_sign_in["Sign in<br/>[SignIn.tsx]"]
  node_profile_setup["Profile setup<br/>[ProfileSetup.tsx]"]
  node_profile["Student profile<br/>[Profile.tsx]"]
end

subgraph group_backend["Backend API"]
  node_api_client["HTTP API client<br/>[api.ts]"]
  node_django_routes["API routes<br/>[urls.py]"]
  node_api_views["API handlers<br/>[views.py]"]
  node_serializers["Data serializers<br/>[serializers.py]"]
  node_domain_store[("Study data models<br/>[models.py]")]
end

node_student(("Student"))
node_live_service["Live collaboration service"]
node_notifications["Session notifications"]

node_student -->|"opens"| node_app_entry
node_app_entry -->|"renders"| node_navbar
node_app_entry -->|"renders"| node_footer
node_app_entry -->|"routes to"| node_home
node_app_entry -->|"routes to"| node_group_search
node_app_entry -->|"routes to"| node_group_create
node_app_entry -->|"routes to"| node_study_hub
node_app_entry -->|"routes to"| node_scheduling
node_app_entry -->|"routes to"| node_resources
node_app_entry -->|"routes to"| node_sign_in
node_app_entry -->|"routes to"| node_profile_setup
node_app_entry -->|"routes to"| node_profile
node_group_search -->|"requests data"| node_api_client
node_group_search -->|"uses curriculum"| node_curriculum
node_group_create -->|"submits circle"| node_api_client
node_study_hub -->|"requests data"| node_api_client
node_scheduling -->|"manages sessions"| node_api_client
node_scheduling -->|"uses curriculum"| node_curriculum
node_resources -->|"manages resources"| node_api_client
node_resources -->|"uses curriculum"| node_curriculum
node_sign_in -->|"authenticates"| node_api_client
node_profile_setup -->|"updates profile"| node_api_client
node_profile -->|"loads profile"| node_api_client
node_api_client -.->|"HTTP requests"| node_django_routes
node_django_routes -->|"dispatches"| node_api_views
node_api_views -->|"serializes data"| node_serializers
node_serializers -->|"maps models"| node_domain_store
node_api_views -->|"reads and writes"| node_domain_store
node_study_hub -.->|"supports live collaboration"| node_live_service
node_scheduling -.->|"provides updates"| node_notifications

click node_app_entry "https://github.com/gdlion1/studysync/blob/main/src/main.tsx"
click node_navbar "https://github.com/gdlion1/studysync/blob/main/src/components/Navbar.tsx"
click node_footer "https://github.com/gdlion1/studysync/blob/main/src/components/Footer.tsx"
click node_home "https://github.com/gdlion1/studysync/blob/main/src/pages/Home.tsx"
click node_group_search "https://github.com/gdlion1/studysync/blob/main/src/pages/FindGroups.tsx"
click node_group_create "https://github.com/gdlion1/studysync/blob/main/src/pages/CreateGroup.tsx"
click node_study_hub "https://github.com/gdlion1/studysync/blob/main/src/pages/StudyHub.tsx"
click node_scheduling "https://github.com/gdlion1/studysync/blob/main/src/pages/Schedule.tsx"
click node_resources "https://github.com/gdlion1/studysync/blob/main/src/pages/Resources.tsx"
click node_curriculum "https://github.com/gdlion1/studysync/blob/main/src/data/vtuData.ts"
click node_sign_in "https://github.com/gdlion1/studysync/blob/main/src/pages/SignIn.tsx"
click node_profile_setup "https://github.com/gdlion1/studysync/blob/main/src/pages/ProfileSetup.tsx"
click node_profile "https://github.com/gdlion1/studysync/blob/main/src/pages/Profile.tsx"
click node_api_client "https://github.com/gdlion1/studysync/blob/main/src/lib/api.ts"
click node_django_routes "https://github.com/gdlion1/studysync/blob/main/server/api/urls.py"
click node_api_views "https://github.com/gdlion1/studysync/blob/main/server/api/views.py"
click node_serializers "https://github.com/gdlion1/studysync/blob/main/server/api/serializers.py"
click node_domain_store "https://github.com/gdlion1/studysync/blob/main/server/api/models.py"

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_entry,node_navbar,node_footer,node_home toneBlue
class node_group_search,node_group_create,node_study_hub toneAmber
class node_scheduling,node_resources,node_curriculum toneMint
class node_sign_in,node_profile_setup,node_profile toneRose
class node_api_client,node_django_routes,node_api_views,node_serializers,node_domain_store,node_student,node_live_service,node_notifications toneIndigo
```

## Components

### Application shell

- [Router and shell](https://github.com/gdlion1/studysync/blob/main/src/main.tsx): `src/main.tsx`
- [Navigation](https://github.com/gdlion1/studysync/blob/main/src/components/Navbar.tsx): `src/components/Navbar.tsx`
- [Footer](https://github.com/gdlion1/studysync/blob/main/src/components/Footer.tsx): `src/components/Footer.tsx`
- [Home](https://github.com/gdlion1/studysync/blob/main/src/pages/Home.tsx): `src/pages/Home.tsx`

### Study circles

- [Find circles](https://github.com/gdlion1/studysync/blob/main/src/pages/FindGroups.tsx): `src/pages/FindGroups.tsx`
- [Create circle](https://github.com/gdlion1/studysync/blob/main/src/pages/CreateGroup.tsx): `src/pages/CreateGroup.tsx`
- [Study hub](https://github.com/gdlion1/studysync/blob/main/src/pages/StudyHub.tsx): `src/pages/StudyHub.tsx`

### Academic tools

- [Sessions and focus](https://github.com/gdlion1/studysync/blob/main/src/pages/Schedule.tsx): `src/pages/Schedule.tsx`
- [Study resources](https://github.com/gdlion1/studysync/blob/main/src/pages/Resources.tsx): `src/pages/Resources.tsx`
- [VTU curriculum data](https://github.com/gdlion1/studysync/blob/main/src/data/vtuData.ts): `src/data/vtuData.ts`

### Student identity

- [Sign in](https://github.com/gdlion1/studysync/blob/main/src/pages/SignIn.tsx): `src/pages/SignIn.tsx`
- [Profile setup](https://github.com/gdlion1/studysync/blob/main/src/pages/ProfileSetup.tsx): `src/pages/ProfileSetup.tsx`
- [Student profile](https://github.com/gdlion1/studysync/blob/main/src/pages/Profile.tsx): `src/pages/Profile.tsx`

### Backend API

- [HTTP API client](https://github.com/gdlion1/studysync/blob/main/src/lib/api.ts): `src/lib/api.ts`
- [API routes](https://github.com/gdlion1/studysync/blob/main/server/api/urls.py): `server/api/urls.py`
- [API handlers](https://github.com/gdlion1/studysync/blob/main/server/api/views.py): `server/api/views.py`
- [Data serializers](https://github.com/gdlion1/studysync/blob/main/server/api/serializers.py): `server/api/serializers.py`
- [Study data models](https://github.com/gdlion1/studysync/blob/main/server/api/models.py): `server/api/models.py`

### Other components

- **Student**
- **Live collaboration service**
- **Session notifications**

## Connections

- Student → Router and shell: opens (evidence: `src/main.tsx`)
- Router and shell → Navigation: renders (evidence: `src/main.tsx`)
- Router and shell → Footer: renders (evidence: `src/main.tsx`)
- Router and shell → Home: routes to (evidence: `src/main.tsx`)
- Router and shell → Find circles: routes to (evidence: `src/main.tsx`)
- Router and shell → Create circle: routes to (evidence: `src/main.tsx`)
- Router and shell → Study hub: routes to (evidence: `src/main.tsx`)
- Router and shell → Sessions and focus: routes to (evidence: `src/main.tsx`)
- Router and shell → Study resources: routes to (evidence: `src/main.tsx`)
- Router and shell → Sign in: routes to (evidence: `src/main.tsx`)
- Router and shell → Profile setup: routes to (evidence: `src/main.tsx`)
- Router and shell → Student profile: routes to (evidence: `src/main.tsx`)
- Find circles → HTTP API client: requests data (evidence: `src/pages/FindGroups.tsx`)
- Find circles → VTU curriculum data: uses curriculum (evidence: `src/pages/FindGroups.tsx`)
- Create circle → HTTP API client: submits circle (evidence: `src/pages/CreateGroup.tsx`)
- Study hub → HTTP API client: requests data (evidence: `src/pages/StudyHub.tsx`)
- Sessions and focus → HTTP API client: manages sessions (evidence: `src/pages/Schedule.tsx`)
- Sessions and focus → VTU curriculum data: uses curriculum (evidence: `src/pages/Schedule.tsx`)
- Study resources → HTTP API client: manages resources (evidence: `src/pages/Resources.tsx`)
- Study resources → VTU curriculum data: uses curriculum (evidence: `src/pages/Resources.tsx`)
- Sign in → HTTP API client: authenticates (evidence: `src/pages/SignIn.tsx`)
- Profile setup → HTTP API client: updates profile (evidence: `src/pages/ProfileSetup.tsx`)
- Student profile → HTTP API client: loads profile (evidence: `src/pages/Profile.tsx`)
- HTTP API client → API routes: HTTP requests (evidence: `README.md`)
- API routes → API handlers: dispatches (evidence: `server/api/urls.py`)
- API handlers → Data serializers: serializes data (evidence: `server/api/views.py`)
- Data serializers → Study data models: maps models (evidence: `server/api/serializers.py`)
- API handlers → Study data models: reads and writes (evidence: `server/api/views.py`)
- Study hub → Live collaboration service: supports live collaboration (evidence: `README.md`)
- Sessions and focus → Session notifications: provides updates (evidence: `README.md`)
