# gdgchennai/devfest26-web architecture

> Architecture diagram of the GitHub repository gdgchennai/devfest26-web, 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/gdgchennai/devfest26-web
- Repository: https://github.com/gdgchennai/devfest26-web

## Overview

DevFest 2026 Chennai is an event website for discovering the conference, choosing tickets, saving an agenda, and playing tech mini-games. Visitors browse event pages backed by shared configuration and agenda/speaker/archive content; ticket pages guide selection, while Google sign-in unlocks a profile and saved sessions. Games start sessions, validate play through server-side rules, and expose scoreboards. The graph also preserves creator/partner promotion, markdown content, and the visual motion layer. Evidence is limited to the excerpts, SOURCE INDEX references, and README; several subsystem links are documented rather than confirmed from route source.

Main entry points: [`lib/content.ts`](https://github.com/gdgchennai/devfest26-web/blob/main/lib/content.ts) (Event content), [`app/api/favorites/route.ts`](https://github.com/gdgchennai/devfest26-web/blob/main/app/api/favorites/route.ts) (Favorites API), [`app/api/games/session/route.ts`](https://github.com/gdgchennai/devfest26-web/blob/main/app/api/games/session/route.ts) (Game session API), [`components/games/GamesHub.tsx`](https://github.com/gdgchennai/devfest26-web/blob/main/components/games/GamesHub.tsx) (Games hub)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_event["Event discovery"]
  node_home["Home experience<br/>[page.tsx]"]
  node_agenda["Agenda browsing<br/>[page.tsx]"]
  node_speakers["Speaker profiles<br/>[page.tsx]"]
  node_memories["Photo memories<br/>[page.tsx]"]
  node_creators["Creator invitation<br/>[page.tsx]"]
  node_partner["Partner information<br/>[page.tsx]"]
end

subgraph group_accounts["Accounts and tickets"]
  node_signin["Google sign-in<br/>[page.tsx]"]
  node_auth["Auth.js identity<br/>[auth.ts]"]
  node_users["User records<br/>[users.ts]"]
  node_profile["Account profile<br/>[page.tsx]"]
  node_tickets["Ticket selection<br/>[page.tsx]"]
  node_ticket_data["Ticket records<br/>[tickets.ts]"]
  node_agenda_saved["Saved agenda<br/>[page.tsx]"]
  node_favorites_api["Favorites API<br/>[route.ts]"]
  node_favorites["Favorite storage<br/>[favorites.ts]"]
  node_database[("D1 database<br/>[db.ts]")]
end

subgraph group_games["Mini-games"]
  node_games_hub["Games hub<br/>[GamesHub.tsx]"]
  node_session_api["Game session API<br/>[route.ts]"]
  node_session_actions["Session actions<br/>[route.ts]"]
  node_game_content["Game content<br/>[games-content.ts]"]
  node_game_rules["Game rules<br/>[game-rules.ts]"]
  node_sessions["Game sessions<br/>[game-sessions.ts]"]
  node_scores["Leaderboards<br/>[route.ts]"]
  node_leaderboard["Score service<br/>[leaderboard.ts]"]
  node_games_ui["Game interfaces"]
end

subgraph group_delivery["Content and presentation"]
  node_content["Event content<br/>[content.ts]"]
  node_config["Event configuration<br/>[site.config.ts]"]
  node_motion["Motion experience<br/>[BracketsField.tsx]"]
  node_markdown["Markdown pages"]
  node_markdown_index["Markdown metadata<br/>[markdown.ts]"]
end

node_visitor(("Visitor"))

node_visitor -->|"browses"| node_home
node_visitor -->|"browses"| node_agenda
node_visitor -.->|"browses"| node_speakers
node_visitor -->|"views"| node_memories
node_visitor -.->|"selects tickets"| node_tickets
node_visitor -.->|"plays"| node_games_hub
node_home -->|"loads content"| node_content
node_agenda -->|"loads agenda"| node_content
node_speakers -->|"loads speaker"| node_content
node_memories -->|"loads archive"| node_content
node_content -->|"reads documents"| node_database
node_content -->|"uses fallback"| node_config
node_home -->|"renders"| node_motion
node_agenda -->|"renders"| node_motion
node_memories -->|"renders"| node_motion
node_visitor -.->|"views"| node_creators
node_visitor -.->|"views"| node_partner
node_visitor -.->|"requests markdown"| node_markdown
node_markdown -->|"formats content"| node_markdown_index
node_visitor -.->|"signs in"| node_signin
node_signin -.->|"initiates sign-in"| node_auth
node_auth -->|"upserts identity"| node_users
node_profile -->|"checks session"| node_auth
node_profile -->|"loads user"| node_users
node_profile -->|"loads ticket"| node_ticket_data
node_visitor -.->|"manages favorites"| node_favorites_api
node_favorites_api -->|"checks identity"| node_auth
node_favorites_api -->|"validates session"| node_content
node_favorites_api -->|"updates favorites"| node_favorites
node_favorites -->|"reads and writes"| node_database
node_agenda_saved -.->|"loads favorites"| node_favorites
node_visitor -.->|"opens games"| node_games_hub
node_games_hub -.->|"starts session"| node_session_api
node_session_api -->|"loads puzzles"| node_game_content
node_session_api -->|"generates layouts"| node_game_rules
node_session_api -->|"creates session"| node_sessions
node_session_actions -->|"loads game data"| node_game_content
node_session_actions -->|"validates play"| node_game_rules
node_session_actions -->|"updates session"| node_sessions
node_sessions -->|"persists runs"| node_database
node_visitor -.->|"views scores"| node_scores
node_scores -->|"loads rankings"| node_leaderboard
node_leaderboard -->|"reads scores"| node_database
node_games_hub -.->|"renders games"| node_games_ui

click node_home "https://github.com/gdgchennai/devfest26-web/blob/main/app/page.tsx"
click node_agenda "https://github.com/gdgchennai/devfest26-web/blob/main/app/agenda/page.tsx"
click node_speakers "https://github.com/gdgchennai/devfest26-web/blob/main/app/speakers/%5Bslug%5D/page.tsx"
click node_memories "https://github.com/gdgchennai/devfest26-web/blob/main/app/memories/page.tsx"
click node_creators "https://github.com/gdgchennai/devfest26-web/blob/main/app/creators/page.tsx"
click node_partner "https://github.com/gdgchennai/devfest26-web/blob/main/app/partner/page.tsx"
click node_content "https://github.com/gdgchennai/devfest26-web/blob/main/lib/content.ts"
click node_config "https://github.com/gdgchennai/devfest26-web/blob/main/site.config.ts"
click node_motion "https://github.com/gdgchennai/devfest26-web/blob/main/components/motion/BracketsField.tsx"
click node_markdown "https://github.com/gdgchennai/devfest26-web/tree/main/app/md"
click node_markdown_index "https://github.com/gdgchennai/devfest26-web/blob/main/lib/markdown.ts"
click node_signin "https://github.com/gdgchennai/devfest26-web/blob/main/app/signin/page.tsx"
click node_auth "https://github.com/gdgchennai/devfest26-web/blob/main/auth.ts"
click node_users "https://github.com/gdgchennai/devfest26-web/blob/main/lib/users.ts"
click node_profile "https://github.com/gdgchennai/devfest26-web/blob/main/app/profile/page.tsx"
click node_tickets "https://github.com/gdgchennai/devfest26-web/blob/main/app/tickets/select/page.tsx"
click node_ticket_data "https://github.com/gdgchennai/devfest26-web/blob/main/lib/tickets.ts"
click node_agenda_saved "https://github.com/gdgchennai/devfest26-web/blob/main/app/my-agenda/page.tsx"
click node_favorites_api "https://github.com/gdgchennai/devfest26-web/blob/main/app/api/favorites/route.ts"
click node_favorites "https://github.com/gdgchennai/devfest26-web/blob/main/lib/favorites.ts"
click node_database "https://github.com/gdgchennai/devfest26-web/blob/main/lib/db.ts"
click node_games_hub "https://github.com/gdgchennai/devfest26-web/blob/main/components/games/GamesHub.tsx"
click node_session_api "https://github.com/gdgchennai/devfest26-web/blob/main/app/api/games/session/route.ts"
click node_session_actions "https://github.com/gdgchennai/devfest26-web/blob/main/app/api/games/session/%5Baction%5D/route.ts"
click node_game_content "https://github.com/gdgchennai/devfest26-web/blob/main/lib/games-content.ts"
click node_game_rules "https://github.com/gdgchennai/devfest26-web/blob/main/lib/game-rules.ts"
click node_sessions "https://github.com/gdgchennai/devfest26-web/blob/main/lib/game-sessions.ts"
click node_scores "https://github.com/gdgchennai/devfest26-web/blob/main/app/api/games/scores/route.ts"
click node_leaderboard "https://github.com/gdgchennai/devfest26-web/blob/main/lib/leaderboard.ts"
click node_games_ui "https://github.com/gdgchennai/devfest26-web/tree/main/components/games"

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_agenda,node_speakers,node_memories,node_creators,node_partner toneBlue
class node_signin,node_auth,node_users,node_profile,node_tickets,node_ticket_data,node_agenda_saved,node_favorites_api,node_favorites,node_database toneAmber
class node_games_hub,node_session_api,node_session_actions,node_game_content,node_game_rules,node_sessions,node_scores,node_leaderboard,node_games_ui toneMint
class node_content,node_config,node_motion,node_markdown,node_markdown_index toneRose
class node_visitor toneIndigo
```

## Components

### Event discovery

- [Home experience](https://github.com/gdgchennai/devfest26-web/blob/main/app/page.tsx): `app/page.tsx`
- [Agenda browsing](https://github.com/gdgchennai/devfest26-web/blob/main/app/agenda/page.tsx): `app/agenda/page.tsx`
- [Speaker profiles](https://github.com/gdgchennai/devfest26-web/blob/main/app/speakers/%5Bslug%5D/page.tsx): `app/speakers/[slug]/page.tsx`
- [Photo memories](https://github.com/gdgchennai/devfest26-web/blob/main/app/memories/page.tsx): `app/memories/page.tsx`
- [Creator invitation](https://github.com/gdgchennai/devfest26-web/blob/main/app/creators/page.tsx): `app/creators/page.tsx`
- [Partner information](https://github.com/gdgchennai/devfest26-web/blob/main/app/partner/page.tsx): `app/partner/page.tsx`

### Accounts and tickets

- [Google sign-in](https://github.com/gdgchennai/devfest26-web/blob/main/app/signin/page.tsx): `app/signin/page.tsx`
- [Auth.js identity](https://github.com/gdgchennai/devfest26-web/blob/main/auth.ts): `auth.ts`
- [User records](https://github.com/gdgchennai/devfest26-web/blob/main/lib/users.ts): `lib/users.ts`
- [Account profile](https://github.com/gdgchennai/devfest26-web/blob/main/app/profile/page.tsx): `app/profile/page.tsx`
- [Ticket selection](https://github.com/gdgchennai/devfest26-web/blob/main/app/tickets/select/page.tsx): `app/tickets/select/page.tsx`
- [Ticket records](https://github.com/gdgchennai/devfest26-web/blob/main/lib/tickets.ts): `lib/tickets.ts`
- [Saved agenda](https://github.com/gdgchennai/devfest26-web/blob/main/app/my-agenda/page.tsx): `app/my-agenda/page.tsx`
- [Favorites API](https://github.com/gdgchennai/devfest26-web/blob/main/app/api/favorites/route.ts): `app/api/favorites/route.ts`
- [Favorite storage](https://github.com/gdgchennai/devfest26-web/blob/main/lib/favorites.ts): `lib/favorites.ts`
- [D1 database](https://github.com/gdgchennai/devfest26-web/blob/main/lib/db.ts): `lib/db.ts`

### Mini-games

- [Games hub](https://github.com/gdgchennai/devfest26-web/blob/main/components/games/GamesHub.tsx): `components/games/GamesHub.tsx`
- [Game session API](https://github.com/gdgchennai/devfest26-web/blob/main/app/api/games/session/route.ts): `app/api/games/session/route.ts`
- [Session actions](https://github.com/gdgchennai/devfest26-web/blob/main/app/api/games/session/%5Baction%5D/route.ts): `app/api/games/session/[action]/route.ts`
- [Game content](https://github.com/gdgchennai/devfest26-web/blob/main/lib/games-content.ts): `lib/games-content.ts`
- [Game rules](https://github.com/gdgchennai/devfest26-web/blob/main/lib/game-rules.ts): `lib/game-rules.ts`
- [Game sessions](https://github.com/gdgchennai/devfest26-web/blob/main/lib/game-sessions.ts): `lib/game-sessions.ts`
- [Leaderboards](https://github.com/gdgchennai/devfest26-web/blob/main/app/api/games/scores/route.ts): `app/api/games/scores/route.ts`
- [Score service](https://github.com/gdgchennai/devfest26-web/blob/main/lib/leaderboard.ts): `lib/leaderboard.ts`
- [Game interfaces](https://github.com/gdgchennai/devfest26-web/tree/main/components/games): `components/games`

### Content and presentation

- [Event content](https://github.com/gdgchennai/devfest26-web/blob/main/lib/content.ts): `lib/content.ts`
- [Event configuration](https://github.com/gdgchennai/devfest26-web/blob/main/site.config.ts): `site.config.ts`
- [Motion experience](https://github.com/gdgchennai/devfest26-web/blob/main/components/motion/BracketsField.tsx): `components/motion/BracketsField.tsx`
- [Markdown pages](https://github.com/gdgchennai/devfest26-web/tree/main/app/md): `app/md`
- [Markdown metadata](https://github.com/gdgchennai/devfest26-web/blob/main/lib/markdown.ts): `lib/markdown.ts`

### Other components

- **Visitor**

## Connections

- Visitor → Home experience: browses (evidence: `app/page.tsx`)
- Visitor → Agenda browsing: browses (evidence: `app/agenda/page.tsx`)
- Visitor → Speaker profiles: browses
- Visitor → Photo memories: views (evidence: `app/memories/page.tsx`)
- Visitor → Ticket selection: selects tickets
- Visitor → Games hub: plays
- Home experience → Event content: loads content (evidence: `app/page.tsx`)
- Agenda browsing → Event content: loads agenda (evidence: `app/agenda/page.tsx`)
- Speaker profiles → Event content: loads speaker (evidence: `app/speakers/[slug]/page.tsx`)
- Photo memories → Event content: loads archive (evidence: `app/memories/page.tsx`)
- Event content → D1 database: reads documents (evidence: `lib/content.ts`)
- Event content → Event configuration: uses fallback (evidence: `lib/content.ts`)
- Home experience → Motion experience: renders (evidence: `app/page.tsx`)
- Agenda browsing → Motion experience: renders (evidence: `app/agenda/page.tsx`)
- Photo memories → Motion experience: renders (evidence: `app/memories/page.tsx`)
- Visitor → Creator invitation: views
- Visitor → Partner information: views
- Visitor → Markdown pages: requests markdown (evidence: `app/md/speakers/[slug]/route.ts`)
- Markdown pages → Markdown metadata: formats content (evidence: `app/md/speakers/[slug]/route.ts`)
- Visitor → Google sign-in: signs in
- Google sign-in → Auth.js identity: initiates sign-in (evidence: `auth.ts`)
- Auth.js identity → User records: upserts identity (evidence: `auth.ts`)
- Account profile → Auth.js identity: checks session (evidence: `app/profile/page.tsx`)
- Account profile → User records: loads user (evidence: `app/profile/page.tsx`)
- Account profile → Ticket records: loads ticket (evidence: `app/profile/page.tsx`)
- Visitor → Favorites API: manages favorites (evidence: `app/api/favorites/route.ts`)
- Favorites API → Auth.js identity: checks identity (evidence: `app/api/favorites/route.ts`)
- Favorites API → Event content: validates session (evidence: `app/api/favorites/route.ts`)
- Favorites API → Favorite storage: updates favorites (evidence: `app/api/favorites/route.ts`)
- Favorite storage → D1 database: reads and writes (evidence: `lib/favorites.ts`)
- Saved agenda → Favorite storage: loads favorites (evidence: `app/my-agenda/page.tsx`)
- Visitor → Games hub: opens games
- Games hub → Game session API: starts session
- Game session API → Game content: loads puzzles (evidence: `app/api/games/session/route.ts`)
- Game session API → Game rules: generates layouts (evidence: `app/api/games/session/route.ts`)
- Game session API → Game sessions: creates session (evidence: `app/api/games/session/route.ts`)
- Session actions → Game content: loads game data (evidence: `app/api/games/session/[action]/route.ts`)
- Session actions → Game rules: validates play (evidence: `app/api/games/session/[action]/route.ts`)
- Session actions → Game sessions: updates session (evidence: `app/api/games/session/[action]/route.ts`)
- Game sessions → D1 database: persists runs (evidence: `lib/game-sessions.ts`)
- Visitor → Leaderboards: views scores
- Leaderboards → Score service: loads rankings (evidence: `app/api/games/scores/route.ts`)
- Score service → D1 database: reads scores (evidence: `lib/leaderboard.ts`)
- Games hub → Game interfaces: renders games
