# satyakarma1/event-ignite-zone architecture

> Architecture diagram of the GitHub repository satyakarma1/event-ignite-zone, 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/satyakarma1/event-ignite-zone
- Repository: https://github.com/satyakarma1/event-ignite-zone

## Overview

Hackathon Hub is a VIT-focused site for discovering hackathons and coordinating student participation. Visitors browse listings and event details; authenticated students complete onboarding, manage profiles, suggest events, and organize or join teams. Administrators manage hackathons, teams, profiles, and exports. The sampled code shows route-to-function calls, team server-function authorization, and Supabase access; several route implementations and function modules were not sampled, so their internal relationships are left unspecified.

Main entry points: [`src/lib/hackathons.functions.ts`](https://github.com/satyakarma1/event-ignite-zone/blob/main/src/lib/hackathons.functions.ts) (Hackathon functions), [`src/lib/teams.functions.ts`](https://github.com/satyakarma1/event-ignite-zone/blob/main/src/lib/teams.functions.ts) (Team functions), [`src/routes/_authenticated/admin.tsx`](https://github.com/satyakarma1/event-ignite-zone/blob/main/src/routes/_authenticated/admin.tsx) (Admin console), [`src/routes/index.tsx`](https://github.com/satyakarma1/event-ignite-zone/blob/main/src/routes/index.tsx) (Home page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Hackathon discovery"]
  node_home["Home page<br/>[index.tsx]"]
  node_listing["Hackathon listings<br/>[index.tsx]"]
  node_event_detail["Event details<br/>[$id.tsx]"]
  node_event_data["Hackathon functions"]
  node_event_card["Hackathon card<br/>[HackathonCard.tsx]"]
end

subgraph group_identity["Identity and access"]
  node_auth_page["Sign-in<br/>[auth.tsx]"]
  node_auth_guard["Authenticated route guard<br/>[route.tsx]"]
  node_auth_middleware["Function auth middleware<br/>[auth-middleware.ts]"]
  node_authorization["Server authorization<br/>[authz.server.ts]"]
end

subgraph group_participation["Student participation"]
  node_onboarding["Profile onboarding<br/>[onboarding.tsx]"]
  node_profile_page["Student profile<br/>[$regNo.tsx]"]
  node_profile_functions["Profile functions"]
  node_dashboard["Student dashboard<br/>[dashboard.tsx]"]
  node_suggestion["Event suggestions<br/>[suggest.tsx]"]
  node_team_page["Team management<br/>[$id.tsx]"]
  node_team_dialog["Create team dialog"]
  node_team_functions["Team functions<br/>[teams.functions.ts]"]
end

subgraph group_operations["Administration"]
  node_admin["Admin console<br/>[admin.tsx]"]
  node_exports["Admin exports"]
end

subgraph group_services["Backend services"]
  node_browser_client["Browser Supabase client<br/>[client.ts]"]
  node_server_client["Service-role client<br/>[client.server.ts]"]
  node_supabase[("Supabase")]
end

node_visitor(("Visitor"))

node_visitor -->|"browses"| node_home
node_home -->|"loads events"| node_event_data
node_home -->|"loads organizer"| node_profile_functions
node_home -->|"renders cards"| node_event_card
node_listing -->|"loads listings"| node_event_data
node_listing -->|"renders cards"| node_event_card
node_auth_page -->|"uses client"| node_browser_client
node_auth_guard -->|"checks session"| node_browser_client
node_event_data -->|"uses for protected calls"| node_auth_middleware
node_profile_functions -->|"uses for protected calls"| node_auth_middleware
node_team_functions -->|"uses for protected calls"| node_auth_middleware
node_team_functions -->|"checks administrator"| node_authorization
node_event_data -->|"checks administrator"| node_authorization
node_admin -->|"manages events"| node_event_data
node_admin -->|"manages teams"| node_team_functions
node_admin -->|"manages profiles"| node_profile_functions
node_admin -->|"requests exports"| node_exports
node_team_page -->|"uses team actions"| node_team_functions
node_team_dialog -->|"creates team"| node_team_functions
node_event_data -->|"queries data"| node_supabase
node_team_functions -->|"reads and writes"| node_supabase
node_auth_middleware -->|"validates claims"| node_supabase
node_authorization -->|"checks site owner"| node_server_client
node_server_client -->|"connects as service role"| node_supabase
node_browser_client -->|"connects"| node_supabase

click node_home "https://github.com/satyakarma1/event-ignite-zone/blob/main/src/routes/index.tsx"
click node_listing "https://github.com/satyakarma1/event-ignite-zone/blob/main/src/routes/hackathons/index.tsx"
click node_event_detail "https://github.com/satyakarma1/event-ignite-zone/blob/main/src/routes/hackathons/%24id.tsx"
click node_event_data "https://github.com/satyakarma1/event-ignite-zone/blob/main/src/lib/hackathons.functions.ts"
click node_event_card "https://github.com/satyakarma1/event-ignite-zone/blob/main/src/components/HackathonCard.tsx"
click node_auth_page "https://github.com/satyakarma1/event-ignite-zone/blob/main/src/routes/auth.tsx"
click node_auth_guard "https://github.com/satyakarma1/event-ignite-zone/blob/main/src/routes/_authenticated/route.tsx"
click node_auth_middleware "https://github.com/satyakarma1/event-ignite-zone/blob/main/src/integrations/supabase/auth-middleware.ts"
click node_authorization "https://github.com/satyakarma1/event-ignite-zone/blob/main/src/lib/authz.server.ts"
click node_onboarding "https://github.com/satyakarma1/event-ignite-zone/blob/main/src/routes/_authenticated/onboarding.tsx"
click node_profile_page "https://github.com/satyakarma1/event-ignite-zone/blob/main/src/routes/_authenticated/u/%24regNo.tsx"
click node_profile_functions "https://github.com/satyakarma1/event-ignite-zone/blob/main/src/lib/profiles.functions.ts"
click node_dashboard "https://github.com/satyakarma1/event-ignite-zone/blob/main/src/routes/_authenticated/dashboard.tsx"
click node_suggestion "https://github.com/satyakarma1/event-ignite-zone/blob/main/src/routes/_authenticated/suggest.tsx"
click node_team_page "https://github.com/satyakarma1/event-ignite-zone/blob/main/src/routes/_authenticated/teams/%24id.tsx"
click node_team_dialog "https://github.com/satyakarma1/event-ignite-zone/blob/main/src/components/CreateTeamDialog.tsx"
click node_team_functions "https://github.com/satyakarma1/event-ignite-zone/blob/main/src/lib/teams.functions.ts"
click node_admin "https://github.com/satyakarma1/event-ignite-zone/blob/main/src/routes/_authenticated/admin.tsx"
click node_exports "https://github.com/satyakarma1/event-ignite-zone/blob/main/src/lib/exports.functions.ts"
click node_browser_client "https://github.com/satyakarma1/event-ignite-zone/blob/main/src/integrations/supabase/client.ts"
click node_server_client "https://github.com/satyakarma1/event-ignite-zone/blob/main/src/integrations/supabase/client.server.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_home,node_listing,node_event_detail,node_event_data,node_event_card toneBlue
class node_auth_page,node_auth_guard,node_auth_middleware,node_authorization toneAmber
class node_onboarding,node_profile_page,node_profile_functions,node_dashboard,node_suggestion,node_team_page,node_team_dialog,node_team_functions toneMint
class node_admin,node_exports toneRose
class node_browser_client,node_server_client,node_supabase,node_visitor toneIndigo
```

## Components

### Hackathon discovery

- [Home page](https://github.com/satyakarma1/event-ignite-zone/blob/main/src/routes/index.tsx): `src/routes/index.tsx`
- [Hackathon listings](https://github.com/satyakarma1/event-ignite-zone/blob/main/src/routes/hackathons/index.tsx): `src/routes/hackathons/index.tsx`
- [Event details](https://github.com/satyakarma1/event-ignite-zone/blob/main/src/routes/hackathons/%24id.tsx): `src/routes/hackathons/$id.tsx`
- [Hackathon functions](https://github.com/satyakarma1/event-ignite-zone/blob/main/src/lib/hackathons.functions.ts): `src/lib/hackathons.functions.ts`
- [Hackathon card](https://github.com/satyakarma1/event-ignite-zone/blob/main/src/components/HackathonCard.tsx): `src/components/HackathonCard.tsx`

### Identity and access

- [Sign-in](https://github.com/satyakarma1/event-ignite-zone/blob/main/src/routes/auth.tsx): `src/routes/auth.tsx`
- [Authenticated route guard](https://github.com/satyakarma1/event-ignite-zone/blob/main/src/routes/_authenticated/route.tsx): `src/routes/_authenticated/route.tsx`
- [Function auth middleware](https://github.com/satyakarma1/event-ignite-zone/blob/main/src/integrations/supabase/auth-middleware.ts): `src/integrations/supabase/auth-middleware.ts`
- [Server authorization](https://github.com/satyakarma1/event-ignite-zone/blob/main/src/lib/authz.server.ts): `src/lib/authz.server.ts`

### Student participation

- [Profile onboarding](https://github.com/satyakarma1/event-ignite-zone/blob/main/src/routes/_authenticated/onboarding.tsx): `src/routes/_authenticated/onboarding.tsx`
- [Student profile](https://github.com/satyakarma1/event-ignite-zone/blob/main/src/routes/_authenticated/u/%24regNo.tsx): `src/routes/_authenticated/u/$regNo.tsx`
- [Profile functions](https://github.com/satyakarma1/event-ignite-zone/blob/main/src/lib/profiles.functions.ts): `src/lib/profiles.functions.ts`
- [Student dashboard](https://github.com/satyakarma1/event-ignite-zone/blob/main/src/routes/_authenticated/dashboard.tsx): `src/routes/_authenticated/dashboard.tsx`
- [Event suggestions](https://github.com/satyakarma1/event-ignite-zone/blob/main/src/routes/_authenticated/suggest.tsx): `src/routes/_authenticated/suggest.tsx`
- [Team management](https://github.com/satyakarma1/event-ignite-zone/blob/main/src/routes/_authenticated/teams/%24id.tsx): `src/routes/_authenticated/teams/$id.tsx`
- [Create team dialog](https://github.com/satyakarma1/event-ignite-zone/blob/main/src/components/CreateTeamDialog.tsx): `src/components/CreateTeamDialog.tsx`
- [Team functions](https://github.com/satyakarma1/event-ignite-zone/blob/main/src/lib/teams.functions.ts): `src/lib/teams.functions.ts`

### Administration

- [Admin console](https://github.com/satyakarma1/event-ignite-zone/blob/main/src/routes/_authenticated/admin.tsx): `src/routes/_authenticated/admin.tsx`
- [Admin exports](https://github.com/satyakarma1/event-ignite-zone/blob/main/src/lib/exports.functions.ts): `src/lib/exports.functions.ts`

### Backend services

- [Browser Supabase client](https://github.com/satyakarma1/event-ignite-zone/blob/main/src/integrations/supabase/client.ts): `src/integrations/supabase/client.ts`
- [Service-role client](https://github.com/satyakarma1/event-ignite-zone/blob/main/src/integrations/supabase/client.server.ts): `src/integrations/supabase/client.server.ts`
- **Supabase**

### Other components

- **Visitor**

## Connections

- Visitor → Home page: browses (evidence: `src/routes/index.tsx`)
- Home page → Hackathon functions: loads events (evidence: `src/routes/index.tsx`)
- Home page → Profile functions: loads organizer (evidence: `src/routes/index.tsx`)
- Home page → Hackathon card: renders cards (evidence: `src/routes/index.tsx`)
- Hackathon listings → Hackathon functions: loads listings (evidence: `src/routes/hackathons/index.tsx`)
- Hackathon listings → Hackathon card: renders cards (evidence: `src/routes/hackathons/index.tsx`)
- Sign-in → Browser Supabase client: uses client (evidence: `src/routes/auth.tsx`)
- Authenticated route guard → Browser Supabase client: checks session (evidence: `src/routes/_authenticated/route.tsx`)
- Hackathon functions → Function auth middleware: uses for protected calls (evidence: `src/lib/hackathons.functions.ts`)
- Profile functions → Function auth middleware: uses for protected calls (evidence: `src/lib/profiles.functions.ts`)
- Team functions → Function auth middleware: uses for protected calls (evidence: `src/lib/teams.functions.ts`)
- Team functions → Server authorization: checks administrator (evidence: `src/lib/teams.functions.ts`)
- Hackathon functions → Server authorization: checks administrator (evidence: `src/lib/hackathons.functions.ts`)
- Admin console → Hackathon functions: manages events (evidence: `src/routes/_authenticated/admin.tsx`)
- Admin console → Team functions: manages teams (evidence: `src/routes/_authenticated/admin.tsx`)
- Admin console → Profile functions: manages profiles (evidence: `src/routes/_authenticated/admin.tsx`)
- Admin console → Admin exports: requests exports (evidence: `src/routes/_authenticated/admin.tsx`)
- Team management → Team functions: uses team actions (evidence: `src/routes/_authenticated/teams/$id.tsx`)
- Create team dialog → Team functions: creates team (evidence: `src/components/CreateTeamDialog.tsx`)
- Hackathon functions → Supabase: queries data (evidence: `src/lib/hackathons.functions.ts`)
- Team functions → Supabase: reads and writes (evidence: `src/lib/teams.functions.ts`)
- Function auth middleware → Supabase: validates claims (evidence: `src/integrations/supabase/auth-middleware.ts`)
- Server authorization → Service-role client: checks site owner (evidence: `src/lib/authz.server.ts`)
- Service-role client → Supabase: connects as service role (evidence: `src/integrations/supabase/client.server.ts`)
- Browser Supabase client → Supabase: connects (evidence: `src/integrations/supabase/client.ts`)
