# anandkumar-codes/kleos-international-school architecture

> Architecture diagram of the GitHub repository anandkumar-codes/kleos-international-school, 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/anandkumar-codes/kleos-international-school
- Repository: https://github.com/anandkumar-codes/kleos-international-school

## Overview

Kleos is a school digital platform spanning a public website, parent/student portals, an administration dashboard with CMS, and a companion Expo mobile app. The main web flow routes visitors to school information and admissions enquiries, while authenticated families and staff reach role-specific portal or admin features. Admin content edits share browser-persisted state with the public site. Mobile routes and experiences are documented in the README, but their implementation and links to website data were not sampled; those connections are therefore documented rather than inferred from imports.

Main entry points: [`src/App.jsx`](https://github.com/anandkumar-codes/kleos-international-school/blob/main/src/App.jsx) (Web Router), [`src/services/store.jsx`](https://github.com/anandkumar-codes/kleos-international-school/blob/main/src/services/store.jsx) (Shared App State), [`src/pages/admin/AdminRoutes.jsx`](https://github.com/anandkumar-codes/kleos-international-school/blob/main/src/pages/admin/AdminRoutes.jsx) (Admin Routes), [`src/pages/public`](https://github.com/anandkumar-codes/kleos-international-school/tree/main/src/pages/public) (Public Pages)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public Website"]
  node_webapp["Web Router<br/>[App.jsx]"]
  node_publicpages["Public Pages"]
  node_enquiry["Admissions Enquiry<br/>[EnquiryForm.jsx]"]
end

subgraph group_portals["Family Portals"]
  node_portal["Parent &amp; Student Portals<br/>[PortalRoutes.jsx]"]
end

subgraph group_admin["School Administration"]
  node_adminroutes["Admin Routes<br/>[AdminRoutes.jsx]"]
  node_adminops["School Operations<br/>[Office.jsx]"]
  node_people["People Management<br/>[People.jsx]"]
  node_communications["Comms &amp; Reports<br/>[Comms.jsx]"]
  node_cms["Website CMS<br/>[Content.jsx]"]
end

subgraph group_platform["Shared Web Platform"]
  node_auth["Role Authentication<br/>[auth.jsx]"]
  node_store["Shared App State<br/>[store.jsx]"]
  node_browserstore[("Browser Storage")]
  node_schooldata["School Content Data<br/>[content.js]"]
  node_records["School Records<br/>[records.js]"]
end

subgraph group_mobile["Mobile App"]
  node_mobile["Mobile Experiences"]
  node_mobileportal["Mobile Portal Screens<br/>[portal.js]"]
end

node_visitor(("Visitor"))
node_portaluser(("Portal User"))
node_staff(("School Staff"))
node_mobileuser(("Mobile User"))

node_visitor -->|"opens"| node_webapp
node_webapp -->|"routes to"| node_publicpages
node_publicpages -->|"renders"| node_enquiry
node_portaluser -->|"opens portal"| node_webapp
node_webapp -->|"guards routes"| node_auth
node_webapp -->|"loads"| node_portal
node_staff -->|"opens admin"| node_webapp
node_webapp -->|"loads"| node_adminroutes
node_adminroutes -->|"routes to"| node_adminops
node_adminroutes -->|"routes to"| node_people
node_adminroutes -->|"routes to"| node_communications
node_adminroutes -->|"routes to"| node_cms
node_cms -->|"updates"| node_store
node_adminops -->|"updates"| node_store
node_communications -->|"reads and updates"| node_store
node_store -->|"persists collections"| node_browserstore
node_store -->|"loads defaults"| node_schooldata
node_store -->|"generates records"| node_records
node_publicpages -->|"reads CMS state"| node_store
node_mobileuser -->|"uses"| node_mobile
node_mobile -->|"includes portal screens"| node_mobileportal
node_mobile -.->|"reuses website data"| node_schooldata

click node_webapp "https://github.com/anandkumar-codes/kleos-international-school/blob/main/src/App.jsx"
click node_publicpages "https://github.com/anandkumar-codes/kleos-international-school/tree/main/src/pages/public"
click node_enquiry "https://github.com/anandkumar-codes/kleos-international-school/blob/main/src/components/public/EnquiryForm.jsx"
click node_portal "https://github.com/anandkumar-codes/kleos-international-school/blob/main/src/pages/portal/PortalRoutes.jsx"
click node_adminroutes "https://github.com/anandkumar-codes/kleos-international-school/blob/main/src/pages/admin/AdminRoutes.jsx"
click node_adminops "https://github.com/anandkumar-codes/kleos-international-school/blob/main/src/pages/admin/Office.jsx"
click node_people "https://github.com/anandkumar-codes/kleos-international-school/blob/main/src/pages/admin/People.jsx"
click node_communications "https://github.com/anandkumar-codes/kleos-international-school/blob/main/src/pages/admin/Comms.jsx"
click node_cms "https://github.com/anandkumar-codes/kleos-international-school/blob/main/src/pages/admin/Content.jsx"
click node_auth "https://github.com/anandkumar-codes/kleos-international-school/blob/main/src/services/auth.jsx"
click node_store "https://github.com/anandkumar-codes/kleos-international-school/blob/main/src/services/store.jsx"
click node_schooldata "https://github.com/anandkumar-codes/kleos-international-school/blob/main/src/data/content.js"
click node_records "https://github.com/anandkumar-codes/kleos-international-school/blob/main/src/data/records.js"
click node_mobile "https://github.com/anandkumar-codes/kleos-international-school/tree/main/mobile/src/app"
click node_mobileportal "https://github.com/anandkumar-codes/kleos-international-school/blob/main/mobile/src/screens/portal.js"

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_webapp,node_publicpages,node_enquiry,node_portaluser,node_mobileuser toneBlue
class node_portal toneAmber
class node_adminroutes,node_adminops,node_people,node_communications,node_cms toneMint
class node_auth,node_store,node_browserstore,node_schooldata,node_records toneRose
class node_mobile,node_mobileportal,node_visitor,node_staff toneIndigo
```

## Components

### Public Website

- [Web Router](https://github.com/anandkumar-codes/kleos-international-school/blob/main/src/App.jsx): `src/App.jsx`
- [Public Pages](https://github.com/anandkumar-codes/kleos-international-school/tree/main/src/pages/public): `src/pages/public`
- [Admissions Enquiry](https://github.com/anandkumar-codes/kleos-international-school/blob/main/src/components/public/EnquiryForm.jsx): `src/components/public/EnquiryForm.jsx`

### Family Portals

- [Parent & Student Portals](https://github.com/anandkumar-codes/kleos-international-school/blob/main/src/pages/portal/PortalRoutes.jsx): `src/pages/portal/PortalRoutes.jsx`

### School Administration

- [Admin Routes](https://github.com/anandkumar-codes/kleos-international-school/blob/main/src/pages/admin/AdminRoutes.jsx): `src/pages/admin/AdminRoutes.jsx`
- [School Operations](https://github.com/anandkumar-codes/kleos-international-school/blob/main/src/pages/admin/Office.jsx): `src/pages/admin/Office.jsx`
- [People Management](https://github.com/anandkumar-codes/kleos-international-school/blob/main/src/pages/admin/People.jsx): `src/pages/admin/People.jsx`
- [Comms & Reports](https://github.com/anandkumar-codes/kleos-international-school/blob/main/src/pages/admin/Comms.jsx): `src/pages/admin/Comms.jsx`
- [Website CMS](https://github.com/anandkumar-codes/kleos-international-school/blob/main/src/pages/admin/Content.jsx): `src/pages/admin/Content.jsx`

### Shared Web Platform

- [Role Authentication](https://github.com/anandkumar-codes/kleos-international-school/blob/main/src/services/auth.jsx): `src/services/auth.jsx`
- [Shared App State](https://github.com/anandkumar-codes/kleos-international-school/blob/main/src/services/store.jsx): `src/services/store.jsx`
- **Browser Storage**
- [School Content Data](https://github.com/anandkumar-codes/kleos-international-school/blob/main/src/data/content.js): `src/data/content.js`
- [School Records](https://github.com/anandkumar-codes/kleos-international-school/blob/main/src/data/records.js): `src/data/records.js`

### Mobile App

- [Mobile Experiences](https://github.com/anandkumar-codes/kleos-international-school/tree/main/mobile/src/app): `mobile/src/app`
- [Mobile Portal Screens](https://github.com/anandkumar-codes/kleos-international-school/blob/main/mobile/src/screens/portal.js): `mobile/src/screens/portal.js`

### Other components

- **Visitor**
- **Portal User**
- **School Staff**
- **Mobile User**

## Connections

- Visitor → Web Router: opens (evidence: `src/App.jsx`)
- Web Router → Public Pages: routes to (evidence: `src/App.jsx`)
- Public Pages → Admissions Enquiry: renders (evidence: `src/pages/public/Home.jsx`)
- Portal User → Web Router: opens portal (evidence: `src/App.jsx`)
- Web Router → Role Authentication: guards routes (evidence: `src/App.jsx`)
- Web Router → Parent & Student Portals: loads (evidence: `src/App.jsx`)
- School Staff → Web Router: opens admin (evidence: `src/App.jsx`)
- Web Router → Admin Routes: loads (evidence: `src/App.jsx`)
- Admin Routes → School Operations: routes to (evidence: `src/pages/admin/AdminRoutes.jsx`)
- Admin Routes → People Management: routes to (evidence: `src/pages/admin/AdminRoutes.jsx`)
- Admin Routes → Comms & Reports: routes to (evidence: `src/pages/admin/AdminRoutes.jsx`)
- Admin Routes → Website CMS: routes to (evidence: `src/pages/admin/AdminRoutes.jsx`)
- Website CMS → Shared App State: updates (evidence: `src/pages/admin/Content.jsx`)
- School Operations → Shared App State: updates (evidence: `src/pages/admin/Office.jsx`)
- Comms & Reports → Shared App State: reads and updates (evidence: `src/pages/admin/Comms.jsx`)
- Shared App State → Browser Storage: persists collections (evidence: `src/services/store.jsx`)
- Shared App State → School Content Data: loads defaults (evidence: `src/services/store.jsx`)
- Shared App State → School Records: generates records (evidence: `src/services/store.jsx`)
- Public Pages → Shared App State: reads CMS state (evidence: `src/pages/public/Home.jsx`)
- Mobile User → Mobile Experiences: uses (evidence: `README.md`)
- Mobile Experiences → Mobile Portal Screens: includes portal screens (evidence: `README.md`)
- Mobile Experiences → School Content Data: reuses website data (evidence: `README.md`)
