# peramihomartin288-png/kwaya-ya-vijana-admin architecture

> Architecture diagram of the GitHub repository peramihomartin288-png/kwaya-ya-vijana-admin, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/peramihomartin288-png/kwaya-ya-vijana-admin
- Repository: https://github.com/peramihomartin288-png/kwaya-ya-vijana-admin

## Overview

This is a Swahili-language Catholic content administration application, rather than the generic React/Vite product described by its README. Administrators enter through authentication and protected routes, then manage dashboard information, liturgical and daily content, media, settings, users, live features, and notifications. The sampled code confirms Supabase-backed content operations and Cloudinary/Uploadcare media uploads. Several listed capabilities are unsampled, so their nodes reflect the tree and routing evidence; uncertain internal flows are omitted.

Main entry points: [`src/router.jsx`](https://github.com/peramihomartin288-png/kwaya-ya-vijana-admin/blob/main/src/router.jsx) (Protected Router), [`src/pages/daily-cards`](https://github.com/peramihomartin288-png/kwaya-ya-vijana-admin/tree/main/src/pages/daily-cards) (Daily Cards), [`src/lib/supabase.js`](https://github.com/peramihomartin288-png/kwaya-ya-vijana-admin/blob/main/src/lib/supabase.js) (Supabase Client), [`src/components/MediaPicker.jsx`](https://github.com/peramihomartin288-png/kwaya-ya-vijana-admin/blob/main/src/components/MediaPicker.jsx) (Media Picker)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and Access"]
  node_app["Application Shell<br/>[App.jsx]"]
  node_auth["Auth Context<br/>[AuthContext.jsx]"]
  node_router["Protected Router<br/>[router.jsx]"]
  node_admin_layout["Admin Layout<br/>[AdminLayout.jsx]"]
end

subgraph group_content["Content Management"]
  node_daily_cards["Daily Cards"]
  node_masomo["Sunday Readings<br/>[MasomoDominika.jsx]"]
  node_watakatifu["Saints Cards<br/>[Watakatifu.jsx]"]
  node_wimbo["Daily Hymns<br/>[WimboWaSiku.jsx]"]
  node_tafakari["Reflections<br/>[Tafakari.jsx]"]
  node_liturgical["Liturgical Colors"]
  node_content_pages["Media Content Pages"]
  node_other_content["Other Content"]
end

subgraph group_media["Media Management"]
  node_media_library["Media Library<br/>[MediaLibrary.jsx]"]
  node_media_picker["Media Picker<br/>[MediaPicker.jsx]"]
  node_audio_trimmer["Audio Trimmer<br/>[AudioTrimmer.jsx]"]
  node_cloudinary["Cloudinary Uploads<br/>[cloudinary.js]"]
  node_uploadcare["Uploadcare Uploads<br/>[uploadcare.js]"]
end

subgraph group_admin["Admin Operations"]
  node_dashboard["Dashboard and Analytics"]
  node_users["User Management<br/>[Users.jsx]"]
  node_admin_management["Admin Management"]
  node_notifications["Notifications<br/>[Notifications.jsx]"]
  node_live["Live Features<br/>[Live.jsx]"]
  node_settings_pages["Site Settings"]
end

subgraph group_services["Backend Services"]
  node_supabase["Supabase Client<br/>[supabase.js]"]
  node_masomo_service["Readings Data<br/>[masomo.js]"]
  node_liturgical_service["Liturgical Data<br/>[liturgical.js]"]
  node_settings_service["Settings Data<br/>[settings.js]"]
end

node_administrator(("Administrator"))
node_notification_service["Notification Endpoint"]

node_administrator -->|"uses"| node_app
node_app -->|"provides auth"| node_auth
node_app -->|"renders routes"| node_router
node_router -->|"routes through"| node_admin_layout
node_router -->|"routes to"| node_dashboard
node_router -->|"routes to"| node_users
node_router -->|"routes to"| node_admin_management
node_router -->|"routes to"| node_notifications
node_router -->|"routes to"| node_live
node_router -->|"routes to"| node_media_library
node_router -->|"routes to"| node_liturgical
node_router -->|"routes to"| node_daily_cards
node_router -->|"routes to"| node_content_pages
node_router -->|"routes to"| node_other_content
node_router -->|"routes to"| node_settings_pages
node_daily_cards -.->|"includes"| node_masomo
node_daily_cards -.->|"includes"| node_watakatifu
node_daily_cards -.->|"includes"| node_wimbo
node_daily_cards -.->|"includes"| node_tafakari
node_masomo -->|"loads and saves"| node_masomo_service
node_liturgical -->|"uses data"| node_liturgical_service
node_settings_pages -->|"uses settings"| node_settings_service
node_settings_service -->|"queries"| node_supabase
node_masomo_service -->|"queries"| node_supabase
node_liturgical_service -->|"queries"| node_supabase
node_notifications -->|"reads and updates"| node_supabase
node_notifications -->|"posts notification"| node_notification_service
node_media_library -->|"uploads media"| node_cloudinary
node_media_library -->|"uploads media"| node_uploadcare
node_media_picker -->|"uploads files"| node_cloudinary
node_media_picker -->|"uploads files"| node_uploadcare
node_media_picker -->|"renders trimmer"| node_audio_trimmer
node_audio_trimmer -->|"uses upload"| node_uploadcare
node_dashboard -->|"loads dashboard data"| node_supabase

click node_app "https://github.com/peramihomartin288-png/kwaya-ya-vijana-admin/blob/main/src/App.jsx"
click node_auth "https://github.com/peramihomartin288-png/kwaya-ya-vijana-admin/blob/main/src/context/AuthContext.jsx"
click node_router "https://github.com/peramihomartin288-png/kwaya-ya-vijana-admin/blob/main/src/router.jsx"
click node_admin_layout "https://github.com/peramihomartin288-png/kwaya-ya-vijana-admin/blob/main/src/components/AdminLayout.jsx"
click node_daily_cards "https://github.com/peramihomartin288-png/kwaya-ya-vijana-admin/tree/main/src/pages/daily-cards"
click node_masomo "https://github.com/peramihomartin288-png/kwaya-ya-vijana-admin/blob/main/src/pages/daily-cards/MasomoDominika.jsx"
click node_watakatifu "https://github.com/peramihomartin288-png/kwaya-ya-vijana-admin/blob/main/src/pages/daily-cards/Watakatifu.jsx"
click node_wimbo "https://github.com/peramihomartin288-png/kwaya-ya-vijana-admin/blob/main/src/pages/daily-cards/WimboWaSiku.jsx"
click node_tafakari "https://github.com/peramihomartin288-png/kwaya-ya-vijana-admin/blob/main/src/pages/daily-cards/Tafakari.jsx"
click node_liturgical "https://github.com/peramihomartin288-png/kwaya-ya-vijana-admin/blob/main/src/pages/LiturgicalColors.jsx"
click node_content_pages "https://github.com/peramihomartin288-png/kwaya-ya-vijana-admin/tree/main/src/pages/content"
click node_other_content "https://github.com/peramihomartin288-png/kwaya-ya-vijana-admin/tree/main/src/pages/other-content"
click node_media_library "https://github.com/peramihomartin288-png/kwaya-ya-vijana-admin/blob/main/src/pages/MediaLibrary.jsx"
click node_media_picker "https://github.com/peramihomartin288-png/kwaya-ya-vijana-admin/blob/main/src/components/MediaPicker.jsx"
click node_audio_trimmer "https://github.com/peramihomartin288-png/kwaya-ya-vijana-admin/blob/main/src/components/AudioTrimmer.jsx"
click node_cloudinary "https://github.com/peramihomartin288-png/kwaya-ya-vijana-admin/blob/main/src/lib/cloudinary.js"
click node_uploadcare "https://github.com/peramihomartin288-png/kwaya-ya-vijana-admin/blob/main/src/lib/uploadcare.js"
click node_dashboard "https://github.com/peramihomartin288-png/kwaya-ya-vijana-admin/tree/main/src/pages/dashboard"
click node_users "https://github.com/peramihomartin288-png/kwaya-ya-vijana-admin/blob/main/src/pages/Users.jsx"
click node_admin_management "https://github.com/peramihomartin288-png/kwaya-ya-vijana-admin/blob/main/src/pages/AdminManagement.jsx"
click node_notifications "https://github.com/peramihomartin288-png/kwaya-ya-vijana-admin/blob/main/src/pages/Notifications.jsx"
click node_live "https://github.com/peramihomartin288-png/kwaya-ya-vijana-admin/blob/main/src/pages/Live.jsx"
click node_settings_pages "https://github.com/peramihomartin288-png/kwaya-ya-vijana-admin/tree/main/src/pages/settings"
click node_supabase "https://github.com/peramihomartin288-png/kwaya-ya-vijana-admin/blob/main/src/lib/supabase.js"
click node_masomo_service "https://github.com/peramihomartin288-png/kwaya-ya-vijana-admin/blob/main/src/lib/masomo.js"
click node_liturgical_service "https://github.com/peramihomartin288-png/kwaya-ya-vijana-admin/blob/main/src/lib/liturgical.js"
click node_settings_service "https://github.com/peramihomartin288-png/kwaya-ya-vijana-admin/blob/main/src/lib/settings.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_app,node_auth,node_router,node_admin_layout toneBlue
class node_daily_cards,node_masomo,node_watakatifu,node_wimbo,node_tafakari,node_liturgical,node_content_pages,node_other_content toneAmber
class node_media_library,node_media_picker,node_audio_trimmer,node_cloudinary,node_uploadcare toneMint
class node_dashboard,node_users,node_admin_management,node_notifications,node_live,node_settings_pages toneRose
class node_supabase,node_masomo_service,node_liturgical_service,node_settings_service,node_administrator,node_notification_service toneIndigo
```

## Components

### App and Access

- [Application Shell](https://github.com/peramihomartin288-png/kwaya-ya-vijana-admin/blob/main/src/App.jsx): `src/App.jsx`
- [Auth Context](https://github.com/peramihomartin288-png/kwaya-ya-vijana-admin/blob/main/src/context/AuthContext.jsx): `src/context/AuthContext.jsx`
- [Protected Router](https://github.com/peramihomartin288-png/kwaya-ya-vijana-admin/blob/main/src/router.jsx): `src/router.jsx`
- [Admin Layout](https://github.com/peramihomartin288-png/kwaya-ya-vijana-admin/blob/main/src/components/AdminLayout.jsx): `src/components/AdminLayout.jsx`

### Content Management

- [Daily Cards](https://github.com/peramihomartin288-png/kwaya-ya-vijana-admin/tree/main/src/pages/daily-cards): `src/pages/daily-cards`
- [Sunday Readings](https://github.com/peramihomartin288-png/kwaya-ya-vijana-admin/blob/main/src/pages/daily-cards/MasomoDominika.jsx): `src/pages/daily-cards/MasomoDominika.jsx`
- [Saints Cards](https://github.com/peramihomartin288-png/kwaya-ya-vijana-admin/blob/main/src/pages/daily-cards/Watakatifu.jsx): `src/pages/daily-cards/Watakatifu.jsx`
- [Daily Hymns](https://github.com/peramihomartin288-png/kwaya-ya-vijana-admin/blob/main/src/pages/daily-cards/WimboWaSiku.jsx): `src/pages/daily-cards/WimboWaSiku.jsx`
- [Reflections](https://github.com/peramihomartin288-png/kwaya-ya-vijana-admin/blob/main/src/pages/daily-cards/Tafakari.jsx): `src/pages/daily-cards/Tafakari.jsx`
- [Liturgical Colors](https://github.com/peramihomartin288-png/kwaya-ya-vijana-admin/blob/main/src/pages/LiturgicalColors.jsx): `src/pages/LiturgicalColors.jsx`
- [Media Content Pages](https://github.com/peramihomartin288-png/kwaya-ya-vijana-admin/tree/main/src/pages/content): `src/pages/content`
- [Other Content](https://github.com/peramihomartin288-png/kwaya-ya-vijana-admin/tree/main/src/pages/other-content): `src/pages/other-content`

### Media Management

- [Media Library](https://github.com/peramihomartin288-png/kwaya-ya-vijana-admin/blob/main/src/pages/MediaLibrary.jsx): `src/pages/MediaLibrary.jsx`
- [Media Picker](https://github.com/peramihomartin288-png/kwaya-ya-vijana-admin/blob/main/src/components/MediaPicker.jsx): `src/components/MediaPicker.jsx`
- [Audio Trimmer](https://github.com/peramihomartin288-png/kwaya-ya-vijana-admin/blob/main/src/components/AudioTrimmer.jsx): `src/components/AudioTrimmer.jsx`
- [Cloudinary Uploads](https://github.com/peramihomartin288-png/kwaya-ya-vijana-admin/blob/main/src/lib/cloudinary.js): `src/lib/cloudinary.js`
- [Uploadcare Uploads](https://github.com/peramihomartin288-png/kwaya-ya-vijana-admin/blob/main/src/lib/uploadcare.js): `src/lib/uploadcare.js`

### Admin Operations

- [Dashboard and Analytics](https://github.com/peramihomartin288-png/kwaya-ya-vijana-admin/tree/main/src/pages/dashboard): `src/pages/dashboard`
- [User Management](https://github.com/peramihomartin288-png/kwaya-ya-vijana-admin/blob/main/src/pages/Users.jsx): `src/pages/Users.jsx`
- [Admin Management](https://github.com/peramihomartin288-png/kwaya-ya-vijana-admin/blob/main/src/pages/AdminManagement.jsx): `src/pages/AdminManagement.jsx`
- [Notifications](https://github.com/peramihomartin288-png/kwaya-ya-vijana-admin/blob/main/src/pages/Notifications.jsx): `src/pages/Notifications.jsx`
- [Live Features](https://github.com/peramihomartin288-png/kwaya-ya-vijana-admin/blob/main/src/pages/Live.jsx): `src/pages/Live.jsx`
- [Site Settings](https://github.com/peramihomartin288-png/kwaya-ya-vijana-admin/tree/main/src/pages/settings): `src/pages/settings`

### Backend Services

- [Supabase Client](https://github.com/peramihomartin288-png/kwaya-ya-vijana-admin/blob/main/src/lib/supabase.js): `src/lib/supabase.js`
- [Readings Data](https://github.com/peramihomartin288-png/kwaya-ya-vijana-admin/blob/main/src/lib/masomo.js): `src/lib/masomo.js`
- [Liturgical Data](https://github.com/peramihomartin288-png/kwaya-ya-vijana-admin/blob/main/src/lib/liturgical.js): `src/lib/liturgical.js`
- [Settings Data](https://github.com/peramihomartin288-png/kwaya-ya-vijana-admin/blob/main/src/lib/settings.js): `src/lib/settings.js`

### Other components

- **Administrator**
- **Notification Endpoint**

## Connections

- Administrator → Application Shell: uses
- Application Shell → Auth Context: provides auth (evidence: `src/App.jsx`)
- Application Shell → Protected Router: renders routes (evidence: `src/App.jsx`)
- Protected Router → Admin Layout: routes through (evidence: `src/router.jsx`)
- Protected Router → Dashboard and Analytics: routes to (evidence: `src/router.jsx`)
- Protected Router → User Management: routes to (evidence: `src/router.jsx`)
- Protected Router → Admin Management: routes to (evidence: `src/router.jsx`)
- Protected Router → Notifications: routes to (evidence: `src/router.jsx`)
- Protected Router → Live Features: routes to (evidence: `src/router.jsx`)
- Protected Router → Media Library: routes to (evidence: `src/router.jsx`)
- Protected Router → Liturgical Colors: routes to (evidence: `src/router.jsx`)
- Protected Router → Daily Cards: routes to (evidence: `src/router.jsx`)
- Protected Router → Media Content Pages: routes to (evidence: `src/router.jsx`)
- Protected Router → Other Content: routes to (evidence: `src/router.jsx`)
- Protected Router → Site Settings: routes to (evidence: `src/router.jsx`)
- Daily Cards → Sunday Readings: includes
- Daily Cards → Saints Cards: includes
- Daily Cards → Daily Hymns: includes
- Daily Cards → Reflections: includes
- Sunday Readings → Readings Data: loads and saves (evidence: `src/pages/daily-cards/MasomoDominika.jsx`)
- Liturgical Colors → Liturgical Data: uses data (evidence: `src/pages/LiturgicalColors.jsx`)
- Site Settings → Settings Data: uses settings (evidence: `src/pages/settings/About.jsx`)
- Settings Data → Supabase Client: queries (evidence: `src/lib/settings.js`)
- Readings Data → Supabase Client: queries (evidence: `src/lib/masomo.js`)
- Liturgical Data → Supabase Client: queries (evidence: `src/lib/liturgical.js`)
- Notifications → Supabase Client: reads and updates (evidence: `src/pages/Notifications.jsx`)
- Notifications → Notification Endpoint: posts notification (evidence: `src/pages/Notifications.jsx`)
- Media Library → Cloudinary Uploads: uploads media (evidence: `src/pages/MediaLibrary.jsx`)
- Media Library → Uploadcare Uploads: uploads media (evidence: `src/pages/MediaLibrary.jsx`)
- Media Picker → Cloudinary Uploads: uploads files (evidence: `src/components/MediaPicker.jsx`)
- Media Picker → Uploadcare Uploads: uploads files (evidence: `src/components/MediaPicker.jsx`)
- Media Picker → Audio Trimmer: renders trimmer (evidence: `src/components/MediaPicker.jsx`)
- Audio Trimmer → Uploadcare Uploads: uses upload (evidence: `src/components/AudioTrimmer.jsx`)
- Dashboard and Analytics → Supabase Client: loads dashboard data (evidence: `src/pages/dashboard/DashboardHome.jsx`)
