# mehsam1999/civora-social-development-events-website architecture

> Architecture diagram of the GitHub repository mehsam1999/civora-social-development-events-website, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mehsam1999/civora-social-development-events-website
- Repository: https://github.com/mehsam1999/civora-social-development-events-website

## Overview

CIVORA is a community-event platform for discovering events, organizing them, joining initiatives, and tracking participation. The principal workflow runs from event discovery and detail viewing to joining; organizers create events and later manage, edit, or delete them. Authentication protects account-specific actions. The README describes a separate Express REST API and MongoDB, but their implementation is not in this tree; API links therefore represent documented HTTP interactions, not inspected backend code.

Main entry points: [`src/app/manage-events/page.tsx`](https://github.com/mehsam1999/civora-social-development-events-website/blob/main/src/app/manage-events/page.tsx) (Manage events), [`src/lib/getTokenFromClient.ts`](https://github.com/mehsam1999/civora-social-development-events-website/blob/main/src/lib/getTokenFromClient.ts) (Client token), [`src/app/upcoming-events/page.tsx`](https://github.com/mehsam1999/civora-social-development-events-website/blob/main/src/app/upcoming-events/page.tsx) (Browse events), [`src/app/joined-events/page.tsx`](https://github.com/mehsam1999/civora-social-development-events-website/blob/main/src/app/joined-events/page.tsx) (Joined events)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Event experience"]
  node_home["Homepage<br/>[page.tsx]"]
  node_home_upcoming["Recent events"]
  node_browse["Browse events<br/>[page.tsx]"]
  node_event_detail["Event details<br/>[page.tsx]"]
  node_join_action["Join event<br/>[JoinEventCard.tsx]"]
  node_joined_list["Joined events<br/>[page.tsx]"]
  node_joined_card["Participation details"]
  node_joined_types["Joined-event model"]
end

subgraph group_organizing["Event organizing"]
  node_create["Create event<br/>[page.tsx]"]
  node_manage["Manage events<br/>[page.tsx]"]
  node_edit["Edit event"]
  node_delete["Delete event"]
  node_event_types["Event model<br/>[events.ts]"]
  node_manage_types["Managed-event model"]
end

subgraph group_identity["Identity and access"]
  node_signup["Sign up<br/>[page.tsx]"]
  node_login["Sign in<br/>[page.tsx]"]
  node_auth_client["Auth client<br/>[auth-client.ts]"]
  node_client_token["Client token"]
  node_auth_server["Auth service<br/>[auth.ts]"]
  node_auth_route["Auth route<br/>[route.ts]"]
  node_server_token["Server token"]
end

subgraph group_presentation["Shared presentation"]
  node_ui_controls["Form controls<br/>[input.tsx]"]
  node_theme["Theme toggle<br/>[ThemeToggle.tsx]"]
  node_navbar["Navigation<br/>[navbar.tsx]"]
end

node_visitor(("Visitor or volunteer"))
node_mongo[("MongoDB")]
node_api["Express REST API"]

node_visitor -->|"visits"| node_home
node_home -->|"renders"| node_home_upcoming
node_home_upcoming -->|"fetches events"| node_api
node_visitor -->|"browses"| node_browse
node_browse -->|"fetches events"| node_api
node_browse -->|"opens details"| node_event_detail
node_event_detail -->|"renders"| node_join_action
node_join_action -.->|"joins event"| node_api
node_visitor -.->|"tracks participation"| node_joined_list
node_joined_list -.->|"loads joined events"| node_api
node_joined_list -->|"renders"| node_joined_card
node_visitor -->|"creates event"| node_create
node_create -->|"gets token"| node_client_token
node_create -->|"posts event"| node_api
node_visitor -->|"manages events"| node_manage
node_manage -->|"gets token"| node_client_token
node_manage -->|"loads events"| node_api
node_manage -->|"offers editing"| node_edit
node_manage -->|"offers deletion"| node_delete
node_edit -->|"gets token"| node_client_token
node_edit -->|"patches event"| node_api
node_delete -->|"gets token"| node_client_token
node_delete -.->|"deletes event"| node_api
node_visitor -->|"creates account"| node_signup
node_visitor -->|"signs in"| node_login
node_signup -.->|"uses auth"| node_auth_client
node_login -.->|"uses auth"| node_auth_client
node_client_token -->|"requests token"| node_auth_client
node_auth_route -->|"delegates to"| node_auth_server
node_auth_server -->|"stores auth data"| node_mongo
node_server_token -->|"reads session"| node_auth_server
node_manage -->|"uses model"| node_manage_types
node_joined_list -->|"uses model"| node_joined_types
node_event_detail -->|"uses model"| node_event_types
node_browse -->|"uses model"| node_event_types
node_create -->|"renders controls"| node_ui_controls
node_visitor -.->|"navigates"| node_navbar
node_navbar -->|"offers theme switch"| node_theme

click node_home "https://github.com/mehsam1999/civora-social-development-events-website/blob/main/src/app/page.tsx"
click node_home_upcoming "https://github.com/mehsam1999/civora-social-development-events-website/blob/main/src/components/homepage/HomeUpcomingEvents.tsx"
click node_browse "https://github.com/mehsam1999/civora-social-development-events-website/blob/main/src/app/upcoming-events/page.tsx"
click node_event_detail "https://github.com/mehsam1999/civora-social-development-events-website/blob/main/src/app/upcoming-events/%5Bid%5D/page.tsx"
click node_join_action "https://github.com/mehsam1999/civora-social-development-events-website/blob/main/src/components/joined%20event%20card/JoinEventCard.tsx"
click node_joined_list "https://github.com/mehsam1999/civora-social-development-events-website/blob/main/src/app/joined-events/page.tsx"
click node_joined_card "https://github.com/mehsam1999/civora-social-development-events-website/blob/main/src/components/joined%20event%20card/JoinEventDetailsCard.tsx"
click node_create "https://github.com/mehsam1999/civora-social-development-events-website/blob/main/src/app/create-events/page.tsx"
click node_manage "https://github.com/mehsam1999/civora-social-development-events-website/blob/main/src/app/manage-events/page.tsx"
click node_edit "https://github.com/mehsam1999/civora-social-development-events-website/blob/main/src/components/dialog/EditEventDialog.tsx"
click node_delete "https://github.com/mehsam1999/civora-social-development-events-website/blob/main/src/components/dialog/DeleteEventDialog.tsx"
click node_signup "https://github.com/mehsam1999/civora-social-development-events-website/blob/main/src/app/signup/page.tsx"
click node_login "https://github.com/mehsam1999/civora-social-development-events-website/blob/main/src/app/login/page.tsx"
click node_auth_client "https://github.com/mehsam1999/civora-social-development-events-website/blob/main/src/lib/auth-client.ts"
click node_client_token "https://github.com/mehsam1999/civora-social-development-events-website/blob/main/src/lib/getTokenFromClient.ts"
click node_auth_server "https://github.com/mehsam1999/civora-social-development-events-website/blob/main/src/lib/auth.ts"
click node_auth_route "https://github.com/mehsam1999/civora-social-development-events-website/blob/main/src/app/api/auth/%5B...all%5D/route.ts"
click node_server_token "https://github.com/mehsam1999/civora-social-development-events-website/blob/main/src/lib/getTokenFromServer.ts"
click node_event_types "https://github.com/mehsam1999/civora-social-development-events-website/blob/main/src/lib/types/events.ts"
click node_joined_types "https://github.com/mehsam1999/civora-social-development-events-website/blob/main/src/lib/types/userJoinedEvents.ts"
click node_manage_types "https://github.com/mehsam1999/civora-social-development-events-website/blob/main/src/lib/types/userManageEvents.ts"
click node_ui_controls "https://github.com/mehsam1999/civora-social-development-events-website/blob/main/src/components/ui/input.tsx"
click node_theme "https://github.com/mehsam1999/civora-social-development-events-website/blob/main/src/components/theme/ThemeToggle.tsx"
click node_navbar "https://github.com/mehsam1999/civora-social-development-events-website/blob/main/src/components/shared/navbar.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_home,node_home_upcoming,node_browse,node_event_detail,node_join_action,node_joined_list,node_joined_card,node_joined_types toneBlue
class node_create,node_manage,node_edit,node_delete,node_event_types,node_manage_types,node_mongo toneAmber
class node_signup,node_login,node_auth_client,node_client_token,node_auth_server,node_auth_route,node_server_token,node_api toneMint
class node_ui_controls,node_theme,node_navbar toneRose
class node_visitor toneIndigo
```

## Components

### Event experience

- [Homepage](https://github.com/mehsam1999/civora-social-development-events-website/blob/main/src/app/page.tsx): `src/app/page.tsx`
- [Recent events](https://github.com/mehsam1999/civora-social-development-events-website/blob/main/src/components/homepage/HomeUpcomingEvents.tsx): `src/components/homepage/HomeUpcomingEvents.tsx`
- [Browse events](https://github.com/mehsam1999/civora-social-development-events-website/blob/main/src/app/upcoming-events/page.tsx): `src/app/upcoming-events/page.tsx`
- [Event details](https://github.com/mehsam1999/civora-social-development-events-website/blob/main/src/app/upcoming-events/%5Bid%5D/page.tsx): `src/app/upcoming-events/[id]/page.tsx`
- [Join event](https://github.com/mehsam1999/civora-social-development-events-website/blob/main/src/components/joined%20event%20card/JoinEventCard.tsx): `src/components/joined event card/JoinEventCard.tsx`
- [Joined events](https://github.com/mehsam1999/civora-social-development-events-website/blob/main/src/app/joined-events/page.tsx): `src/app/joined-events/page.tsx`
- [Participation details](https://github.com/mehsam1999/civora-social-development-events-website/blob/main/src/components/joined%20event%20card/JoinEventDetailsCard.tsx): `src/components/joined event card/JoinEventDetailsCard.tsx`
- [Joined-event model](https://github.com/mehsam1999/civora-social-development-events-website/blob/main/src/lib/types/userJoinedEvents.ts): `src/lib/types/userJoinedEvents.ts`

### Event organizing

- [Create event](https://github.com/mehsam1999/civora-social-development-events-website/blob/main/src/app/create-events/page.tsx): `src/app/create-events/page.tsx`
- [Manage events](https://github.com/mehsam1999/civora-social-development-events-website/blob/main/src/app/manage-events/page.tsx): `src/app/manage-events/page.tsx`
- [Edit event](https://github.com/mehsam1999/civora-social-development-events-website/blob/main/src/components/dialog/EditEventDialog.tsx): `src/components/dialog/EditEventDialog.tsx`
- [Delete event](https://github.com/mehsam1999/civora-social-development-events-website/blob/main/src/components/dialog/DeleteEventDialog.tsx): `src/components/dialog/DeleteEventDialog.tsx`
- [Event model](https://github.com/mehsam1999/civora-social-development-events-website/blob/main/src/lib/types/events.ts): `src/lib/types/events.ts`
- [Managed-event model](https://github.com/mehsam1999/civora-social-development-events-website/blob/main/src/lib/types/userManageEvents.ts): `src/lib/types/userManageEvents.ts`

### Identity and access

- [Sign up](https://github.com/mehsam1999/civora-social-development-events-website/blob/main/src/app/signup/page.tsx): `src/app/signup/page.tsx`
- [Sign in](https://github.com/mehsam1999/civora-social-development-events-website/blob/main/src/app/login/page.tsx): `src/app/login/page.tsx`
- [Auth client](https://github.com/mehsam1999/civora-social-development-events-website/blob/main/src/lib/auth-client.ts): `src/lib/auth-client.ts`
- [Client token](https://github.com/mehsam1999/civora-social-development-events-website/blob/main/src/lib/getTokenFromClient.ts): `src/lib/getTokenFromClient.ts`
- [Auth service](https://github.com/mehsam1999/civora-social-development-events-website/blob/main/src/lib/auth.ts): `src/lib/auth.ts`
- [Auth route](https://github.com/mehsam1999/civora-social-development-events-website/blob/main/src/app/api/auth/%5B...all%5D/route.ts): `src/app/api/auth/[...all]/route.ts`
- [Server token](https://github.com/mehsam1999/civora-social-development-events-website/blob/main/src/lib/getTokenFromServer.ts): `src/lib/getTokenFromServer.ts`

### Shared presentation

- [Form controls](https://github.com/mehsam1999/civora-social-development-events-website/blob/main/src/components/ui/input.tsx): `src/components/ui/input.tsx`
- [Theme toggle](https://github.com/mehsam1999/civora-social-development-events-website/blob/main/src/components/theme/ThemeToggle.tsx): `src/components/theme/ThemeToggle.tsx`
- [Navigation](https://github.com/mehsam1999/civora-social-development-events-website/blob/main/src/components/shared/navbar.tsx): `src/components/shared/navbar.tsx`

### Other components

- **Visitor or volunteer**
- **MongoDB**
- **Express REST API**

## Connections

- Visitor or volunteer → Homepage: visits (evidence: `src/app/page.tsx`)
- Homepage → Recent events: renders (evidence: `src/app/page.tsx`)
- Recent events → Express REST API: fetches events (evidence: `src/components/homepage/HomeUpcomingEvents.tsx`)
- Visitor or volunteer → Browse events: browses (evidence: `src/app/upcoming-events/page.tsx`)
- Browse events → Express REST API: fetches events (evidence: `src/app/upcoming-events/page.tsx`)
- Browse events → Event details: opens details (evidence: `src/app/upcoming-events/page.tsx`)
- Event details → Join event: renders (evidence: `src/app/upcoming-events/[id]/page.tsx`)
- Join event → Express REST API: joins event
- Visitor or volunteer → Joined events: tracks participation
- Joined events → Express REST API: loads joined events
- Joined events → Participation details: renders (evidence: `src/app/joined-events/page.tsx`)
- Visitor or volunteer → Create event: creates event (evidence: `src/app/create-events/page.tsx`)
- Create event → Client token: gets token (evidence: `src/app/create-events/page.tsx`)
- Create event → Express REST API: posts event (evidence: `src/app/create-events/page.tsx`)
- Visitor or volunteer → Manage events: manages events (evidence: `src/app/manage-events/page.tsx`)
- Manage events → Client token: gets token (evidence: `src/app/manage-events/page.tsx`)
- Manage events → Express REST API: loads events (evidence: `src/app/manage-events/page.tsx`)
- Manage events → Edit event: offers editing (evidence: `src/app/manage-events/page.tsx`)
- Manage events → Delete event: offers deletion (evidence: `src/app/manage-events/page.tsx`)
- Edit event → Client token: gets token (evidence: `src/components/dialog/EditEventDialog.tsx`)
- Edit event → Express REST API: patches event (evidence: `src/components/dialog/EditEventDialog.tsx`)
- Delete event → Client token: gets token (evidence: `src/components/dialog/DeleteEventDialog.tsx`)
- Delete event → Express REST API: deletes event
- Visitor or volunteer → Sign up: creates account
- Visitor or volunteer → Sign in: signs in
- Sign up → Auth client: uses auth (evidence: `src/app/signup/page.tsx`)
- Sign in → Auth client: uses auth (evidence: `src/app/login/page.tsx`)
- Client token → Auth client: requests token (evidence: `src/lib/getTokenFromClient.ts`)
- Auth route → Auth service: delegates to (evidence: `src/app/api/auth/[...all]/route.ts`)
- Auth service → MongoDB: stores auth data (evidence: `src/lib/auth.ts`)
- Server token → Auth service: reads session (evidence: `src/lib/getTokenFromServer.ts`)
- Manage events → Managed-event model: uses model (evidence: `src/app/manage-events/page.tsx`)
- Joined events → Joined-event model: uses model (evidence: `src/app/joined-events/page.tsx`)
- Event details → Event model: uses model (evidence: `src/app/upcoming-events/[id]/page.tsx`)
- Browse events → Event model: uses model (evidence: `src/app/upcoming-events/page.tsx`)
- Create event → Form controls: renders controls (evidence: `src/app/create-events/page.tsx`)
- Visitor or volunteer → Navigation: navigates
- Navigation → Theme toggle: offers theme switch (evidence: `src/components/shared/navbar.tsx`)
