# asiet-iedc/iedc-website architecture

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

- Interactive diagram: https://gitdiagram.com/asiet-iedc/iedc-website
- Repository: https://github.com/asiet-iedc/iedc-website

## Overview

1. This repository is a Next.js App Router frontend, centered on a small set of content pages rather than a backend-heavy application. The main routes are `app/page.tsx`, `about`, `contact`, `events`, `excom`, and `gallery`.

2. The routing layer is file-based under `app/`. Each route has its own `page.tsx`, and `events` and `gallery` also have `loading.tsx`, which suggests those sections may render heavier content or media and benefit from route-level suspense/loading states.

3. `app/layout.tsx` is the global shell for the site. It likely wires together shared chrome and app-wide providers, while `components/navbar.tsx` and `components/footer.tsx` provide the persistent navigation and footer across all pages.

4. The repository is structured like a presentation site with centralized content. `data/data.tsx` is the main place where structured page content, lists, or metadata likely lives, and the page components consume that data to render the route views.

5. The design system is split into a reusable UI layer under `components/ui/`. This is a large shadcn-style component library: buttons, dialogs, menus, sheets, tabs, tables, form controls, toasts, tooltips, and other primitives that page-specific components can compose.

6. Interactivity is lightweight and client-side. The main shared hooks are `hooks/use-mobile.tsx` for responsive behavior and `hooks/use-toast.ts` for notifications, with matching toast UI in `components/ui/toaster.tsx` and `components/ui/sonner.tsx`.

7. A theme boundary exists through `components/theme-provider.tsx`, indicating the site supports global theming, likely including dark/light mode, at the application shell level.

8. Static media is a major part of the architecture. The `public/images` tree is organized by site section (`About`, `Events`, `Gallery`, `excom`, thumbnails), and `public/videos` contains multiple MP4 assets plus a nested project demo folder. This means visual content is served directly from the public filesystem rather than from an API or CMS.

9. Styling is handled with Tailwind and global CSS. The repo includes `tailwind.config.ts`, `postcss.config.mjs`, `app/globals.css`, and `styles/globals.css`, so the visual system is built from utility classes plus shared global styles.

10. The overall data flow is: route page -> shared content/data -> reusable UI components -> static media from `public/` -> global layout/theme/navigation/footer. There is no visible server, database, or external service layer in the tree, so the architecture is mostly a static, component-driven site rendered by Next.js.

Main entry points: [`app/layout.tsx`](https://github.com/asiet-iedc/iedc-website/blob/main/app/layout.tsx) (Root layout), [`data/data.tsx`](https://github.com/asiet-iedc/iedc-website/blob/main/data/data.tsx) (Content data), [`components/ui`](https://github.com/asiet-iedc/iedc-website/tree/main/components/ui) (UI primitives), [`app/events/page.tsx`](https://github.com/asiet-iedc/iedc-website/blob/main/app/events/page.tsx) (Events page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App routes"]
  node_app_layout["Root layout<br/>next layout<br/>[layout.tsx]"]
  node_app_home["Home page<br/>route page<br/>[page.tsx]"]
  node_app_about["About page<br/>route page<br/>[page.tsx]"]
  node_app_contact["Contact page<br/>route page<br/>[page.tsx]"]
  node_app_events["Events page<br/>route page<br/>[page.tsx]"]
  node_app_events_loading(("Events loading<br/>suspense fallback<br/>[loading.tsx]"))
  node_app_excom["Excom page<br/>route page<br/>[page.tsx]"]
  node_app_gallery["Gallery page<br/>route page<br/>[page.tsx]"]
  node_app_gallery_loading(("Gallery loading<br/>suspense fallback<br/>[loading.tsx]"))
end

subgraph group_shared["Shared site"]
  node_site_nav["Navbar<br/>site chrome<br/>[navbar.tsx]"]
  node_site_footer["Footer<br/>site chrome<br/>[footer.tsx]"]
  node_theme_provider["Theme provider<br/>theme boundary<br/>[theme-provider.tsx]"]
end

subgraph group_ui["UI kit"]
  node_ui_primitives["UI primitives<br/>component library"]
  node_ui_toast["Toast system<br/>feedback ui<br/>[toaster.tsx]"]
  node_ui_mobile_hook["Mobile hook<br/>responsive hook<br/>[use-mobile.tsx]"]
end

subgraph group_content["Content"]
  node_page_data["Content data<br/>content store<br/>[data.tsx]"]
  node_media_images[("Image assets<br/>static media")]
  node_media_videos[("Video assets<br/>static media")]
end

subgraph group_styles["Styling"]
  node_global_css["Global CSS<br/>styles<br/>[globals.css]"]
  node_shared_css["Shared styles<br/>[globals.css]"]
  node_tailwind_cfg["Tailwind config<br/>build config<br/>[tailwind.config.ts]"]
end

node_app_layout -->|"wraps"| node_theme_provider
node_app_layout -->|"includes"| node_site_nav
node_app_layout -->|"includes"| node_site_footer
node_app_layout -->|"loads"| node_global_css
node_app_layout -->|"loads"| node_shared_css
node_app_layout -->|"routes to"| node_app_home
node_app_layout -->|"routes to"| node_app_about
node_app_layout -->|"routes to"| node_app_contact
node_app_layout -->|"routes to"| node_app_events
node_app_layout -->|"routes to"| node_app_gallery
node_app_layout -->|"routes to"| node_app_excom
node_app_events -.->|"fallback"| node_app_events_loading
node_app_gallery -.->|"fallback"| node_app_gallery_loading
node_app_home -->|"reads"| node_page_data
node_app_about -->|"reads"| node_page_data
node_app_contact -->|"reads"| node_page_data
node_app_events -->|"reads"| node_page_data
node_app_gallery -->|"reads"| node_page_data
node_app_excom -->|"reads"| node_page_data
node_page_data -->|"references"| node_media_images
node_page_data -->|"references"| node_media_videos
node_app_home -->|"composes"| node_ui_primitives
node_app_about -->|"composes"| node_ui_primitives
node_app_events -->|"composes"| node_ui_primitives
node_app_gallery -->|"composes"| node_ui_primitives
node_ui_primitives -->|"includes"| node_ui_toast
node_ui_primitives -->|"uses"| node_ui_mobile_hook
node_ui_toast -.->|"mounted by"| node_app_layout
node_tailwind_cfg -->|"styles"| node_ui_primitives
node_global_css -->|"works with"| node_tailwind_cfg

click node_app_layout "https://github.com/asiet-iedc/iedc-website/blob/main/app/layout.tsx"
click node_app_home "https://github.com/asiet-iedc/iedc-website/blob/main/app/page.tsx"
click node_app_about "https://github.com/asiet-iedc/iedc-website/blob/main/app/about/page.tsx"
click node_app_contact "https://github.com/asiet-iedc/iedc-website/blob/main/app/contact/page.tsx"
click node_app_events "https://github.com/asiet-iedc/iedc-website/blob/main/app/events/page.tsx"
click node_app_events_loading "https://github.com/asiet-iedc/iedc-website/blob/main/app/events/loading.tsx"
click node_app_excom "https://github.com/asiet-iedc/iedc-website/blob/main/app/excom/page.tsx"
click node_app_gallery "https://github.com/asiet-iedc/iedc-website/blob/main/app/gallery/page.tsx"
click node_app_gallery_loading "https://github.com/asiet-iedc/iedc-website/blob/main/app/gallery/loading.tsx"
click node_site_nav "https://github.com/asiet-iedc/iedc-website/blob/main/components/navbar.tsx"
click node_site_footer "https://github.com/asiet-iedc/iedc-website/blob/main/components/footer.tsx"
click node_theme_provider "https://github.com/asiet-iedc/iedc-website/blob/main/components/theme-provider.tsx"
click node_page_data "https://github.com/asiet-iedc/iedc-website/blob/main/data/data.tsx"
click node_media_images "https://github.com/asiet-iedc/iedc-website/tree/main/public/images"
click node_media_videos "https://github.com/asiet-iedc/iedc-website/tree/main/public/videos"
click node_ui_primitives "https://github.com/asiet-iedc/iedc-website/tree/main/components/ui"
click node_ui_toast "https://github.com/asiet-iedc/iedc-website/blob/main/components/ui/toaster.tsx"
click node_ui_mobile_hook "https://github.com/asiet-iedc/iedc-website/blob/main/components/ui/use-mobile.tsx"
click node_global_css "https://github.com/asiet-iedc/iedc-website/blob/main/app/globals.css"
click node_shared_css "https://github.com/asiet-iedc/iedc-website/blob/main/styles/globals.css"
click node_tailwind_cfg "https://github.com/asiet-iedc/iedc-website/blob/main/tailwind.config.ts"

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_layout,node_app_home,node_app_about,node_app_contact,node_app_events,node_app_events_loading,node_app_excom,node_app_gallery,node_app_gallery_loading toneBlue
class node_site_nav,node_site_footer,node_theme_provider toneAmber
class node_ui_primitives,node_ui_toast,node_ui_mobile_hook toneMint
class node_page_data,node_media_images,node_media_videos toneRose
class node_global_css,node_shared_css,node_tailwind_cfg toneIndigo
```

## Components

### App routes

File-based Next.js App Router pages and route shells.

- [Root layout](https://github.com/asiet-iedc/iedc-website/blob/main/app/layout.tsx): next layout · Global site shell and shared providers. · `app/layout.tsx`
- [Home page](https://github.com/asiet-iedc/iedc-website/blob/main/app/page.tsx): route page · Landing route for the site. · `app/page.tsx`
- [About page](https://github.com/asiet-iedc/iedc-website/blob/main/app/about/page.tsx): route page · About section route. · `app/about/page.tsx`
- [Contact page](https://github.com/asiet-iedc/iedc-website/blob/main/app/contact/page.tsx): route page · Contact section route. · `app/contact/page.tsx`
- [Events page](https://github.com/asiet-iedc/iedc-website/blob/main/app/events/page.tsx): route page · Events section route with loading state. · `app/events/page.tsx`
- [Events loading](https://github.com/asiet-iedc/iedc-website/blob/main/app/events/loading.tsx): suspense fallback · Route-level loading UI for events. · `app/events/loading.tsx`
- [Excom page](https://github.com/asiet-iedc/iedc-website/blob/main/app/excom/page.tsx): route page · Executive committee route. · `app/excom/page.tsx`
- [Gallery page](https://github.com/asiet-iedc/iedc-website/blob/main/app/gallery/page.tsx): route page · Gallery section route with loading state. · `app/gallery/page.tsx`
- [Gallery loading](https://github.com/asiet-iedc/iedc-website/blob/main/app/gallery/loading.tsx): suspense fallback · Route-level loading UI for gallery. · `app/gallery/loading.tsx`

### Shared site

Reusable chrome, theming, and content consumed across routes.

- [Navbar](https://github.com/asiet-iedc/iedc-website/blob/main/components/navbar.tsx): site chrome · Persistent primary navigation. · `components/navbar.tsx`
- [Footer](https://github.com/asiet-iedc/iedc-website/blob/main/components/footer.tsx): site chrome · Persistent site footer. · `components/footer.tsx`
- [Theme provider](https://github.com/asiet-iedc/iedc-website/blob/main/components/theme-provider.tsx): theme boundary · Global theme and color-mode wiring. · `components/theme-provider.tsx`

### UI kit

Composable shadcn-style primitives and helpers.

- [UI primitives](https://github.com/asiet-iedc/iedc-website/tree/main/components/ui): component library · Reusable visual and interaction building blocks. · `components/ui`
- [Toast system](https://github.com/asiet-iedc/iedc-website/blob/main/components/ui/toaster.tsx): feedback ui · Toast providers and notification hooks. · `components/ui/toaster.tsx`
- [Mobile hook](https://github.com/asiet-iedc/iedc-website/blob/main/components/ui/use-mobile.tsx): responsive hook · Shared responsive breakpoint helper. · `components/ui/use-mobile.tsx`

### Content

Structured page data and static media assets.

- [Content data](https://github.com/asiet-iedc/iedc-website/blob/main/data/data.tsx): content store · Central structured site content and metadata. · `data/data.tsx`
- [Image assets](https://github.com/asiet-iedc/iedc-website/tree/main/public/images): static media · Section-organized images served from public. · `public/images`
- [Video assets](https://github.com/asiet-iedc/iedc-website/tree/main/public/videos): static media · Video library served from public. · `public/videos`

### Styling

Global Tailwind and CSS configuration.

- [Global CSS](https://github.com/asiet-iedc/iedc-website/blob/main/app/globals.css): styles · App-wide stylesheet entrypoints. · `app/globals.css`
- [Shared styles](https://github.com/asiet-iedc/iedc-website/blob/main/styles/globals.css): styles · Additional global styling layer. · `styles/globals.css`
- [Tailwind config](https://github.com/asiet-iedc/iedc-website/blob/main/tailwind.config.ts): build config · Utility-first styling configuration. · `tailwind.config.ts`

## Connections

- Root layout → Theme provider: wraps · Root layout provides app-wide theming.
- Root layout → Navbar: includes · Shared navigation is mounted in the shell.
- Root layout → Footer: includes · Shared footer is mounted in the shell.
- Root layout → Global CSS: loads · Global stylesheet is applied at the app root.
- Root layout → Shared styles: loads · Additional site styling is available globally.
- Root layout → Home page: routes to · Root shell serves the home route.
- Root layout → About page: routes to · Root shell serves the about route.
- Root layout → Contact page: routes to · Root shell serves the contact route.
- Root layout → Events page: routes to · Root shell serves the events route.
- Root layout → Gallery page: routes to · Root shell serves the gallery route.
- Root layout → Excom page: routes to · Root shell serves the excom route.
- Events page → Events loading: fallback · Events route has its own loading UI.
- Gallery page → Gallery loading: fallback · Gallery route has its own loading UI.
- Home page → Content data: reads · Home page consumes centralized content.
- About page → Content data: reads · About page consumes centralized content.
- Contact page → Content data: reads · Contact page consumes centralized content.
- Events page → Content data: reads · Events page consumes centralized content.
- Gallery page → Content data: reads · Gallery page consumes centralized content.
- Excom page → Content data: reads · Excom page consumes centralized content.
- Content data → Image assets: references · Structured content points to section images.
- Content data → Video assets: references · Structured content points to video assets.
- Home page → UI primitives: composes · Pages are built from shared UI primitives.
- About page → UI primitives: composes · Pages are built from shared UI primitives.
- Events page → UI primitives: composes · Pages are built from shared UI primitives.
- Gallery page → UI primitives: composes · Pages are built from shared UI primitives.
- UI primitives → Toast system: includes · Primitive set includes notification infrastructure.
- UI primitives → Mobile hook: uses · Primitive components can adapt to mobile layout.
- Toast system → Root layout: mounted by · Toast UI is expected to be mounted in the global shell.
- Tailwind config → UI primitives: styles · Tailwind config supports the shared component kit.
- Global CSS → Tailwind config: works with · Global CSS and Tailwind define the styling layer.
