# manojpatidar10/gurukul_rn architecture

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

- Interactive diagram: https://gitdiagram.com/manojpatidar10/gurukul_rn
- Repository: https://github.com/manojpatidar10/gurukul_rn

## Overview

Gurukul is an Expo school-management app for principals, staff, students, and parents. Users enter through school selection and account setup or sign-in; the app restores session state and routes authenticated users into role-specific navigation. Principal and parent screens expose school operations, including attendance, fees/payroll, academics, admissions, communications, timetable, and AI tools. Domain screens use API modules to work with the backend; the sampled evidence confirms selected navigation, session, and push-notification links, but not most screen-to-API calls.

Main entry points: [`App.tsx`](https://github.com/manojpatidar10/gurukul_rn/blob/main/App.tsx) (App shell), [`src/navigation/PrincipalNavigator.tsx`](https://github.com/manojpatidar10/gurukul_rn/blob/main/src/navigation/PrincipalNavigator.tsx) (Principal navigation), [`src/navigation/ParentNavigator.tsx`](https://github.com/manojpatidar10/gurukul_rn/blob/main/src/navigation/ParentNavigator.tsx) (Parent navigation), [`src/api/client.ts`](https://github.com/manojpatidar10/gurukul_rn/blob/main/src/api/client.ts) (HTTP API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["App entry and identity"]
  node_app["App shell<br/>[App.tsx]"]
  node_school_setup["School onboarding"]
  node_auth["Authentication screens"]
  node_principal_nav["Principal navigation"]
  node_parent_nav["Parent navigation"]
end

subgraph group_operations["School operations"]
  node_attendance["Attendance operations"]
  node_finance["Fees and payroll"]
  node_admissions["Admissions pipeline"]
  node_resources["Vendors and expenses"]
end

subgraph group_learning["Learning and communication"]
  node_academics["Assessments and reports"]
  node_schedule["Timetable tools"]
  node_communications["Messaging and notices"]
  node_ai_tools["AI learning tools"]
  node_gamification["Arena and gamification"]
end

subgraph group_platform["Shared platform"]
  node_api_domains["Domain API modules"]
  node_api_client["HTTP API client<br/>[client.ts]"]
  node_session_store[("Session storage<br/>[authStorage.ts]")]
  node_school_store[("School selection storage<br/>[schoolStorage.ts]")]
  node_push["Push registration"]
  node_notifications_api["Notification API<br/>[notifications.ts]"]
  node_toast["Toast feedback<br/>[ToastContext.tsx]"]
end

node_user(("School user"))

node_user -->|"opens"| node_app
node_app -->|"routes to"| node_principal_nav
node_app -->|"routes to"| node_parent_nav
node_app -->|"restores session"| node_session_store
node_app -->|"sets auth session"| node_api_client
node_app -->|"uses stored school"| node_school_store
node_app -->|"provides feedback"| node_toast
node_principal_nav -->|"registers screens"| node_attendance
node_principal_nav -->|"registers screens"| node_admissions
node_principal_nav -->|"registers screens"| node_academics
node_principal_nav -->|"registers screens"| node_communications
node_principal_nav -->|"registers screens"| node_gamification
node_parent_nav -->|"registers screens"| node_attendance
node_parent_nav -->|"registers screens"| node_academics
node_parent_nav -->|"registers screens"| node_communications
node_school_setup -->|"searches schools"| node_api_domains
node_api_domains -->|"uses transport"| node_api_client
node_api_client -->|"persists refreshed session"| node_session_store
node_push -->|"registers device token"| node_notifications_api

click node_app "https://github.com/manojpatidar10/gurukul_rn/blob/main/App.tsx"
click node_school_setup "https://github.com/manojpatidar10/gurukul_rn/tree/main/src/screens"
click node_auth "https://github.com/manojpatidar10/gurukul_rn/tree/main/src/screens"
click node_principal_nav "https://github.com/manojpatidar10/gurukul_rn/blob/main/src/navigation/PrincipalNavigator.tsx"
click node_parent_nav "https://github.com/manojpatidar10/gurukul_rn/blob/main/src/navigation/ParentNavigator.tsx"
click node_attendance "https://github.com/manojpatidar10/gurukul_rn/tree/main/src/screens/principal"
click node_finance "https://github.com/manojpatidar10/gurukul_rn/tree/main/src/screens/principal"
click node_admissions "https://github.com/manojpatidar10/gurukul_rn/tree/main/src/screens/principal"
click node_resources "https://github.com/manojpatidar10/gurukul_rn/tree/main/src/screens/principal"
click node_academics "https://github.com/manojpatidar10/gurukul_rn/tree/main/src/screens/principal"
click node_schedule "https://github.com/manojpatidar10/gurukul_rn/tree/main/src/screens/principal"
click node_communications "https://github.com/manojpatidar10/gurukul_rn/tree/main/src/screens/principal"
click node_ai_tools "https://github.com/manojpatidar10/gurukul_rn/tree/main/src/screens/principal"
click node_gamification "https://github.com/manojpatidar10/gurukul_rn/tree/main/src/screens/principal"
click node_api_domains "https://github.com/manojpatidar10/gurukul_rn/tree/main/src/api"
click node_api_client "https://github.com/manojpatidar10/gurukul_rn/blob/main/src/api/client.ts"
click node_session_store "https://github.com/manojpatidar10/gurukul_rn/blob/main/src/api/authStorage.ts"
click node_school_store "https://github.com/manojpatidar10/gurukul_rn/blob/main/src/api/schoolStorage.ts"
click node_push "https://github.com/manojpatidar10/gurukul_rn/blob/main/src/hooks/usePushNotifications.ts"
click node_notifications_api "https://github.com/manojpatidar10/gurukul_rn/blob/main/src/api/notifications.ts"
click node_toast "https://github.com/manojpatidar10/gurukul_rn/blob/main/src/context/ToastContext.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,node_school_setup,node_auth,node_principal_nav,node_parent_nav,node_user toneBlue
class node_attendance,node_finance,node_admissions,node_resources toneAmber
class node_academics,node_schedule,node_communications,node_ai_tools,node_gamification toneMint
class node_api_domains,node_api_client,node_session_store,node_school_store,node_push,node_notifications_api,node_toast toneRose
```

## Components

### App entry and identity

- [App shell](https://github.com/manojpatidar10/gurukul_rn/blob/main/App.tsx): `App.tsx`
- [School onboarding](https://github.com/manojpatidar10/gurukul_rn/tree/main/src/screens): `src/screens`
- [Authentication screens](https://github.com/manojpatidar10/gurukul_rn/tree/main/src/screens): `src/screens`
- [Principal navigation](https://github.com/manojpatidar10/gurukul_rn/blob/main/src/navigation/PrincipalNavigator.tsx): `src/navigation/PrincipalNavigator.tsx`
- [Parent navigation](https://github.com/manojpatidar10/gurukul_rn/blob/main/src/navigation/ParentNavigator.tsx): `src/navigation/ParentNavigator.tsx`

### School operations

- [Attendance operations](https://github.com/manojpatidar10/gurukul_rn/tree/main/src/screens/principal): `src/screens/principal`
- [Fees and payroll](https://github.com/manojpatidar10/gurukul_rn/tree/main/src/screens/principal): `src/screens/principal`
- [Admissions pipeline](https://github.com/manojpatidar10/gurukul_rn/tree/main/src/screens/principal): `src/screens/principal`
- [Vendors and expenses](https://github.com/manojpatidar10/gurukul_rn/tree/main/src/screens/principal): `src/screens/principal`

### Learning and communication

- [Assessments and reports](https://github.com/manojpatidar10/gurukul_rn/tree/main/src/screens/principal): `src/screens/principal`
- [Timetable tools](https://github.com/manojpatidar10/gurukul_rn/tree/main/src/screens/principal): `src/screens/principal`
- [Messaging and notices](https://github.com/manojpatidar10/gurukul_rn/tree/main/src/screens/principal): `src/screens/principal`
- [AI learning tools](https://github.com/manojpatidar10/gurukul_rn/tree/main/src/screens/principal): `src/screens/principal`
- [Arena and gamification](https://github.com/manojpatidar10/gurukul_rn/tree/main/src/screens/principal): `src/screens/principal`

### Shared platform

- [Domain API modules](https://github.com/manojpatidar10/gurukul_rn/tree/main/src/api): `src/api`
- [HTTP API client](https://github.com/manojpatidar10/gurukul_rn/blob/main/src/api/client.ts): `src/api/client.ts`
- [Session storage](https://github.com/manojpatidar10/gurukul_rn/blob/main/src/api/authStorage.ts): `src/api/authStorage.ts`
- [School selection storage](https://github.com/manojpatidar10/gurukul_rn/blob/main/src/api/schoolStorage.ts): `src/api/schoolStorage.ts`
- [Push registration](https://github.com/manojpatidar10/gurukul_rn/blob/main/src/hooks/usePushNotifications.ts): `src/hooks/usePushNotifications.ts`
- [Notification API](https://github.com/manojpatidar10/gurukul_rn/blob/main/src/api/notifications.ts): `src/api/notifications.ts`
- [Toast feedback](https://github.com/manojpatidar10/gurukul_rn/blob/main/src/context/ToastContext.tsx): `src/context/ToastContext.tsx`

### Other components

- **School user**

## Connections

- School user → App shell: opens
- App shell → Principal navigation: routes to (evidence: `App.tsx`)
- App shell → Parent navigation: routes to (evidence: `App.tsx`)
- App shell → Session storage: restores session (evidence: `App.tsx`)
- App shell → HTTP API client: sets auth session (evidence: `App.tsx`)
- App shell → School selection storage: uses stored school (evidence: `App.tsx`)
- App shell → Toast feedback: provides feedback (evidence: `App.tsx`)
- Principal navigation → Attendance operations: registers screens (evidence: `src/navigation/PrincipalNavigator.tsx`)
- Principal navigation → Admissions pipeline: registers screens (evidence: `src/navigation/PrincipalNavigator.tsx`)
- Principal navigation → Assessments and reports: registers screens (evidence: `src/navigation/PrincipalNavigator.tsx`)
- Principal navigation → Messaging and notices: registers screens (evidence: `src/navigation/PrincipalNavigator.tsx`)
- Principal navigation → Arena and gamification: registers screens (evidence: `src/navigation/PrincipalNavigator.tsx`)
- Parent navigation → Attendance operations: registers screens (evidence: `src/navigation/ParentNavigator.tsx`)
- Parent navigation → Assessments and reports: registers screens (evidence: `src/navigation/ParentNavigator.tsx`)
- Parent navigation → Messaging and notices: registers screens (evidence: `src/navigation/ParentNavigator.tsx`)
- School onboarding → Domain API modules: searches schools (evidence: `src/screens/SchoolSearchScreen.tsx`)
- Domain API modules → HTTP API client: uses transport (evidence: `src/api/arena.ts`)
- HTTP API client → Session storage: persists refreshed session (evidence: `src/api/client.ts`)
- Push registration → Notification API: registers device token (evidence: `src/hooks/usePushNotifications.ts`)
