# kritt29/ddc-website-frontend architecture

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

- Interactive diagram: https://gitdiagram.com/kritt29/ddc-website-frontend
- Repository: https://github.com/kritt29/ddc-website-frontend

## Overview

This repository is a Digital Defence Club CTF event site, centered on an animated landing-page journey: visitors see the hero, scroll through a signal handoff anchored at Hyderabad, and can continue to the separately implemented challenge-vectors screen. The hero’s motion hook orchestrates entrance and scroll timelines, while the Three.js globe and SVG bridge render the scene. The README documents responsive and reduced-motion behavior, registration feedback, and geometry construction. The source excerpts confirm key render and motion ownership; some secondary wiring is documented rather than sampled, so unverified relationships are omitted.

Main entry points: [`components/vectors/ChallengeVectors.tsx`](https://github.com/kritt29/ddc-website-frontend/blob/main/components/vectors/ChallengeVectors.tsx) (Vectors screen), [`components/hero/HeroScreen.tsx`](https://github.com/kritt29/ddc-website-frontend/blob/main/components/hero/HeroScreen.tsx) (Hero screen), [`components/hero/motion/useHeroMotion.ts`](https://github.com/kritt29/ddc-website-frontend/blob/main/components/hero/motion/useHeroMotion.ts) (Motion lifecycle), [`components/hero/NetworkGlobe.tsx`](https://github.com/kritt29/ddc-website-frontend/blob/main/components/hero/NetworkGlobe.tsx) (Network globe)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_hero["Hero experience"]
  node_home["Home route<br/>[page.tsx]"]
  node_hero_screen["Hero screen<br/>[HeroScreen.tsx]"]
  node_event_content["Event content<br/>[content.ts]"]
  node_globe["Network globe<br/>[NetworkGlobe.tsx]"]
  node_geometry["Globe geometry<br/>[globeGeometry.ts]"]
end

subgraph group_motion["Motion system"]
  node_motion_hook["Motion lifecycle<br/>[useHeroMotion.ts]"]
  node_motion_state["Motion state<br/>[state.ts]"]
  node_intro["Entrance timeline<br/>[intro.ts]"]
  node_scroll["Scroll timelines<br/>[scroll.ts]"]
  node_globe_motion["Globe animation<br/>[globeMotion.ts]"]
  node_signal_bridge["Signal bridge<br/>[SignalBridge.tsx]"]
  node_bridge_logic["Bridge projection<br/>[bridge.ts]"]
end

subgraph group_vectors["Challenge vectors"]
  node_vectors_route["Vectors route<br/>[page.tsx]"]
  node_vectors_screen["Vectors screen"]
  node_vector_content["Vector content<br/>[content.ts]"]
  node_vector_register["Vector registration<br/>[VectorRegister.tsx]"]
  node_vector_object["Vector artwork<br/>[VectorObject.tsx]"]
  node_vector_motion["Vector motion<br/>[useVectorMotion.ts]"]
end

subgraph group_shared["Shared UI"]
  node_dialog["Dialog primitive<br/>[dialog.tsx]"]
end

node_visitor(("Visitor"))

node_visitor -->|"opens"| node_home
node_home -->|"renders"| node_hero_screen
node_hero_screen -->|"reads config"| node_event_content
node_hero_screen -->|"renders"| node_globe
node_hero_screen -->|"renders"| node_signal_bridge
node_hero_screen -->|"starts motion"| node_motion_hook
node_motion_hook -->|"updates"| node_motion_state
node_motion_hook -->|"creates entrance"| node_intro
node_motion_hook -->|"creates timelines"| node_scroll
node_motion_hook -->|"creates bridge"| node_bridge_logic
node_globe -->|"uses coordinates"| node_geometry
node_globe -->|"creates animation"| node_globe_motion
node_globe_motion -->|"builds routes"| node_geometry
node_globe -->|"uses shared state"| node_motion_state
node_signal_bridge -->|"uses projection"| node_bridge_logic
node_visitor -->|"opens"| node_vectors_route
node_vectors_route -->|"renders"| node_vectors_screen
node_vectors_screen -->|"reads content"| node_vector_content
node_vectors_screen -->|"renders"| node_vector_register
node_vectors_screen -->|"renders artwork"| node_vector_object
node_vectors_screen -->|"starts motion"| node_vector_motion
node_vectors_screen -->|"opens details"| node_dialog

click node_home "https://github.com/kritt29/ddc-website-frontend/blob/main/app/page.tsx"
click node_hero_screen "https://github.com/kritt29/ddc-website-frontend/blob/main/components/hero/HeroScreen.tsx"
click node_event_content "https://github.com/kritt29/ddc-website-frontend/blob/main/components/hero/content.ts"
click node_globe "https://github.com/kritt29/ddc-website-frontend/blob/main/components/hero/NetworkGlobe.tsx"
click node_geometry "https://github.com/kritt29/ddc-website-frontend/blob/main/components/hero/globeGeometry.ts"
click node_motion_hook "https://github.com/kritt29/ddc-website-frontend/blob/main/components/hero/motion/useHeroMotion.ts"
click node_motion_state "https://github.com/kritt29/ddc-website-frontend/blob/main/components/hero/motion/state.ts"
click node_intro "https://github.com/kritt29/ddc-website-frontend/blob/main/components/hero/motion/intro.ts"
click node_scroll "https://github.com/kritt29/ddc-website-frontend/blob/main/components/hero/motion/scroll.ts"
click node_globe_motion "https://github.com/kritt29/ddc-website-frontend/blob/main/components/hero/motion/globeMotion.ts"
click node_signal_bridge "https://github.com/kritt29/ddc-website-frontend/blob/main/components/hero/motion/SignalBridge.tsx"
click node_bridge_logic "https://github.com/kritt29/ddc-website-frontend/blob/main/components/hero/motion/bridge.ts"
click node_vectors_route "https://github.com/kritt29/ddc-website-frontend/blob/main/app/challenge-vectors/page.tsx"
click node_vectors_screen "https://github.com/kritt29/ddc-website-frontend/blob/main/components/vectors/ChallengeVectors.tsx"
click node_vector_content "https://github.com/kritt29/ddc-website-frontend/blob/main/components/vectors/content.ts"
click node_vector_register "https://github.com/kritt29/ddc-website-frontend/blob/main/components/vectors/VectorRegister.tsx"
click node_vector_object "https://github.com/kritt29/ddc-website-frontend/blob/main/components/vectors/VectorObject.tsx"
click node_vector_motion "https://github.com/kritt29/ddc-website-frontend/blob/main/components/vectors/useVectorMotion.ts"
click node_dialog "https://github.com/kritt29/ddc-website-frontend/blob/main/components/ui/dialog.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_hero_screen,node_event_content,node_globe,node_geometry toneBlue
class node_motion_hook,node_motion_state,node_intro,node_scroll,node_globe_motion,node_signal_bridge,node_bridge_logic toneAmber
class node_vectors_route,node_vectors_screen,node_vector_content,node_vector_register,node_vector_object,node_vector_motion toneMint
class node_dialog toneRose
class node_visitor toneIndigo
```

## Components

### Hero experience

- [Home route](https://github.com/kritt29/ddc-website-frontend/blob/main/app/page.tsx): `app/page.tsx`
- [Hero screen](https://github.com/kritt29/ddc-website-frontend/blob/main/components/hero/HeroScreen.tsx): `components/hero/HeroScreen.tsx`
- [Event content](https://github.com/kritt29/ddc-website-frontend/blob/main/components/hero/content.ts): `components/hero/content.ts`
- [Network globe](https://github.com/kritt29/ddc-website-frontend/blob/main/components/hero/NetworkGlobe.tsx): `components/hero/NetworkGlobe.tsx`
- [Globe geometry](https://github.com/kritt29/ddc-website-frontend/blob/main/components/hero/globeGeometry.ts): `components/hero/globeGeometry.ts`

### Motion system

- [Motion lifecycle](https://github.com/kritt29/ddc-website-frontend/blob/main/components/hero/motion/useHeroMotion.ts): `components/hero/motion/useHeroMotion.ts`
- [Motion state](https://github.com/kritt29/ddc-website-frontend/blob/main/components/hero/motion/state.ts): `components/hero/motion/state.ts`
- [Entrance timeline](https://github.com/kritt29/ddc-website-frontend/blob/main/components/hero/motion/intro.ts): `components/hero/motion/intro.ts`
- [Scroll timelines](https://github.com/kritt29/ddc-website-frontend/blob/main/components/hero/motion/scroll.ts): `components/hero/motion/scroll.ts`
- [Globe animation](https://github.com/kritt29/ddc-website-frontend/blob/main/components/hero/motion/globeMotion.ts): `components/hero/motion/globeMotion.ts`
- [Signal bridge](https://github.com/kritt29/ddc-website-frontend/blob/main/components/hero/motion/SignalBridge.tsx): `components/hero/motion/SignalBridge.tsx`
- [Bridge projection](https://github.com/kritt29/ddc-website-frontend/blob/main/components/hero/motion/bridge.ts): `components/hero/motion/bridge.ts`

### Challenge vectors

- [Vectors route](https://github.com/kritt29/ddc-website-frontend/blob/main/app/challenge-vectors/page.tsx): `app/challenge-vectors/page.tsx`
- [Vectors screen](https://github.com/kritt29/ddc-website-frontend/blob/main/components/vectors/ChallengeVectors.tsx): `components/vectors/ChallengeVectors.tsx`
- [Vector content](https://github.com/kritt29/ddc-website-frontend/blob/main/components/vectors/content.ts): `components/vectors/content.ts`
- [Vector registration](https://github.com/kritt29/ddc-website-frontend/blob/main/components/vectors/VectorRegister.tsx): `components/vectors/VectorRegister.tsx`
- [Vector artwork](https://github.com/kritt29/ddc-website-frontend/blob/main/components/vectors/VectorObject.tsx): `components/vectors/VectorObject.tsx`
- [Vector motion](https://github.com/kritt29/ddc-website-frontend/blob/main/components/vectors/useVectorMotion.ts): `components/vectors/useVectorMotion.ts`

### Shared UI

- [Dialog primitive](https://github.com/kritt29/ddc-website-frontend/blob/main/components/ui/dialog.tsx): `components/ui/dialog.tsx`

### Other components

- **Visitor**

## Connections

- Visitor → Home route: opens (evidence: `app/page.tsx`)
- Home route → Hero screen: renders (evidence: `app/page.tsx`)
- Hero screen → Event content: reads config (evidence: `components/hero/HeroScreen.tsx`)
- Hero screen → Network globe: renders (evidence: `components/hero/HeroScreen.tsx`)
- Hero screen → Signal bridge: renders (evidence: `components/hero/HeroScreen.tsx`)
- Hero screen → Motion lifecycle: starts motion (evidence: `components/hero/HeroScreen.tsx`)
- Motion lifecycle → Motion state: updates (evidence: `components/hero/motion/useHeroMotion.ts`)
- Motion lifecycle → Entrance timeline: creates entrance (evidence: `components/hero/motion/useHeroMotion.ts`)
- Motion lifecycle → Scroll timelines: creates timelines (evidence: `components/hero/motion/useHeroMotion.ts`)
- Motion lifecycle → Bridge projection: creates bridge (evidence: `components/hero/motion/useHeroMotion.ts`)
- Network globe → Globe geometry: uses coordinates (evidence: `components/hero/NetworkGlobe.tsx`)
- Network globe → Globe animation: creates animation (evidence: `components/hero/NetworkGlobe.tsx`)
- Globe animation → Globe geometry: builds routes (evidence: `components/hero/motion/globeMotion.ts`)
- Network globe → Motion state: uses shared state (evidence: `components/hero/NetworkGlobe.tsx`)
- Signal bridge → Bridge projection: uses projection (evidence: `components/hero/motion/SignalBridge.tsx`)
- Visitor → Vectors route: opens (evidence: `app/challenge-vectors/page.tsx`)
- Vectors route → Vectors screen: renders (evidence: `app/challenge-vectors/page.tsx`)
- Vectors screen → Vector content: reads content (evidence: `components/vectors/ChallengeVectors.tsx`)
- Vectors screen → Vector registration: renders (evidence: `components/vectors/ChallengeVectors.tsx`)
- Vectors screen → Vector artwork: renders artwork (evidence: `components/vectors/ChallengeVectors.tsx`)
- Vectors screen → Vector motion: starts motion (evidence: `components/vectors/ChallengeVectors.tsx`)
- Vectors screen → Dialog primitive: opens details (evidence: `components/vectors/ChallengeVectors.tsx`)
