How kritt29/ddc-website-frontend works
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: ChallengeVectors.tsx Vectors screen · HeroScreen.tsx Hero screen · useHeroMotion.ts Motion lifecycle · NetworkGlobe.tsx Network globe
Components 20
Hero experience
- Home route
app/page.tsx - Hero screen
components/hero/HeroScreen.tsx - Event content
components/hero/content.ts - Network globe
components/hero/NetworkGlobe.tsx - Globe geometry
components/hero/globeGeometry.ts
Motion system
- Motion lifecycle
components/hero/motion/useHeroMotion.ts - Motion state
components/hero/motion/state.ts - Entrance timeline
components/hero/motion/intro.ts - Scroll timelines
components/hero/motion/scroll.ts - Globe animation
components/hero/motion/globeMotion.ts - Signal bridge
components/hero/motion/SignalBridge.tsx - Bridge projection
components/hero/motion/bridge.ts
Challenge vectors
- Vectors route
app/challenge-vectors/page.tsx - Vectors screen
components/vectors/ChallengeVectors.tsx - Vector content
components/vectors/content.ts - Vector registration
components/vectors/VectorRegister.tsx - Vector artwork
components/vectors/VectorObject.tsx - Vector motion
components/vectors/useVectorMotion.ts
Shared UI
- Dialog primitive
components/ui/dialog.tsx
Other components
- Visitor
Connections 22
- Visitor → Home route: opens
app/page.tsx - Home route → Hero screen: renders
app/page.tsx - Hero screen → Event content: reads config
components/hero/HeroScreen.tsx - Hero screen → Network globe: renders
components/hero/HeroScreen.tsx - Hero screen → Signal bridge: renders
components/hero/HeroScreen.tsx - Hero screen → Motion lifecycle: starts motion
components/hero/HeroScreen.tsx - Motion lifecycle → Motion state: updates
components/hero/motion/useHeroMotion.ts - Motion lifecycle → Entrance timeline: creates entrance
components/hero/motion/useHeroMotion.ts - Motion lifecycle → Scroll timelines: creates timelines
components/hero/motion/useHeroMotion.ts - Motion lifecycle → Bridge projection: creates bridge
components/hero/motion/useHeroMotion.ts - Network globe → Globe geometry: uses coordinates
components/hero/NetworkGlobe.tsx - Network globe → Globe animation: creates animation
components/hero/NetworkGlobe.tsx - Globe animation → Globe geometry: builds routes
components/hero/motion/globeMotion.ts - Network globe → Motion state: uses shared state
components/hero/NetworkGlobe.tsx - Signal bridge → Bridge projection: uses projection
components/hero/motion/SignalBridge.tsx - Visitor → Vectors route: opens
app/challenge-vectors/page.tsx - Vectors route → Vectors screen: renders
app/challenge-vectors/page.tsx - Vectors screen → Vector content: reads content
components/vectors/ChallengeVectors.tsx - Vectors screen → Vector registration: renders
components/vectors/ChallengeVectors.tsx - Vectors screen → Vector artwork: renders artwork
components/vectors/ChallengeVectors.tsx - Vectors screen → Vector motion: starts motion
components/vectors/ChallengeVectors.tsx - Vectors screen → Dialog primitive: opens details
components/vectors/ChallengeVectors.tsx