# jkr0805/flashforte architecture

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

- Interactive diagram: https://gitdiagram.com/jkr0805/flashforte
- Repository: https://github.com/jkr0805/flashforte

## Overview

FlashForte 2K26 is a participant-facing event portal: visitors explore event information and schedules, then follow event-specific routes to register, submit work, or leave feedback. The React router connects the landing page, four competition pages, and shared configurable forms; form submissions are posted to a Google Apps Script endpoint. The graph preserves the documented highlights and participation features. Detail is limited to the provided excerpts and SOURCE INDEX, so unsampled capabilities are represented at their documented module paths.

Main entry points: [`src/app/App.jsx`](https://github.com/jkr0805/flashforte/blob/main/src/app/App.jsx) (Route shell), [`src/app/pages/LandingPage.jsx`](https://github.com/jkr0805/flashforte/blob/main/src/app/pages/LandingPage.jsx) (Landing page), [`src/app/components/form/CustomForm.jsx`](https://github.com/jkr0805/flashforte/blob/main/src/app/components/form/CustomForm.jsx) (Form renderer), [`src/app/pages/IdeaThonPage.jsx`](https://github.com/jkr0805/flashforte/blob/main/src/app/pages/IdeaThonPage.jsx) (Ideathon details)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_navigation["Portal routing"]
  node_app["Route shell<br/>[App.jsx]"]
end

subgraph group_discovery["Event discovery"]
  node_landing["Landing page<br/>[LandingPage.jsx]"]
  node_hero["Event hero<br/>[HeroSection.jsx]"]
  node_fortes["Fortes overview"]
  node_archive["Event archive"]
  node_highlights["Past highlights"]
  node_schedule["Schedule cards<br/>[ScheduleCards.jsx]"]
end

subgraph group_competitions["Competition pages"]
  node_ideathon["Ideathon details<br/>[IdeaThonPage.jsx]"]
  node_gameathon["Gameathon details<br/>[GameAThonPage.jsx]"]
  node_speakathon["Speakathon details<br/>[SpeakAThonPage.jsx]"]
  node_designathon["Designathon details"]
end

subgraph group_participation["Participation forms"]
  node_formpage["Form page<br/>[ForteFormPage.jsx]"]
  node_configs["Event form configs"]
  node_commonfields["Common fields<br/>[commonFields.js]"]
  node_customform["Form renderer<br/>[CustomForm.jsx]"]
  node_fieldrenderer["Field renderer<br/>[FieldRenderer.jsx]"]
  node_fileupload["File upload<br/>[FileUpload.jsx]"]
end

subgraph group_shared["Shared interface"]
  node_navbar["Navigation bar<br/>[Navbar.jsx]"]
  node_footer["Footer<br/>[Footer.jsx]"]
  node_imagemodal["Image modal<br/>[ImageModal.jsx]"]
  node_cursor["Cursor effect<br/>[CursorTrail.jsx]"]
  node_stars["Star field<br/>[StarField.jsx]"]
  node_countdown["Countdown<br/>[CountdownTimer.jsx]"]
  node_loader["Universal loader"]
  node_winners["Winners popup<br/>[WinnersPopup.jsx]"]
end

node_participant(("Visitor"))
node_script{{"Apps Script endpoint"}}

node_participant -->|"opens portal"| node_app
node_app -->|"routes to"| node_landing
node_app -->|"routes to"| node_ideathon
node_app -->|"routes to"| node_gameathon
node_app -->|"routes to"| node_speakathon
node_app -->|"routes to"| node_designathon
node_app -->|"routes forms"| node_formpage
node_app -->|"renders"| node_navbar
node_landing -->|"renders"| node_hero
node_landing -->|"renders"| node_fortes
node_landing -->|"renders"| node_archive
node_landing -->|"renders"| node_highlights
node_landing -->|"renders"| node_schedule
node_landing -->|"renders"| node_footer
node_hero -->|"renders"| node_countdown
node_highlights -->|"opens"| node_imagemodal
node_archive -->|"opens"| node_imagemodal
node_ideathon -->|"links registration"| node_formpage
node_app -->|"supplies config"| node_configs
node_configs -->|"uses shared fields"| node_commonfields
node_formpage -->|"renders"| node_customform
node_customform -->|"renders fields"| node_fieldrenderer
node_customform -->|"renders upload"| node_fileupload
node_customform -->|"posts submission"| node_script
node_app -->|"renders in forms"| node_footer
node_navbar -->|"renders popup"| node_winners
node_ideathon -->|"renders"| node_footer
node_landing -->|"renders"| node_cursor
node_landing -->|"renders"| node_stars

click node_app "https://github.com/jkr0805/flashforte/blob/main/src/app/App.jsx"
click node_landing "https://github.com/jkr0805/flashforte/blob/main/src/app/pages/LandingPage.jsx"
click node_hero "https://github.com/jkr0805/flashforte/blob/main/src/app/components/HeroSection.jsx"
click node_fortes "https://github.com/jkr0805/flashforte/blob/main/src/app/components/ChooseYourReality.jsx"
click node_archive "https://github.com/jkr0805/flashforte/blob/main/src/app/components/RealitiesArchive.jsx"
click node_highlights "https://github.com/jkr0805/flashforte/blob/main/src/app/components/PreviousYearHighlights.jsx"
click node_schedule "https://github.com/jkr0805/flashforte/blob/main/src/app/components/ScheduleCards.jsx"
click node_ideathon "https://github.com/jkr0805/flashforte/blob/main/src/app/pages/IdeaThonPage.jsx"
click node_gameathon "https://github.com/jkr0805/flashforte/blob/main/src/app/pages/GameAThonPage.jsx"
click node_speakathon "https://github.com/jkr0805/flashforte/blob/main/src/app/pages/SpeakAThonPage.jsx"
click node_designathon "https://github.com/jkr0805/flashforte/blob/main/src/app/pages/DesignAThonPage.jsx"
click node_formpage "https://github.com/jkr0805/flashforte/blob/main/src/app/components/form/ForteFormPage.jsx"
click node_configs "https://github.com/jkr0805/flashforte/tree/main/src/app/components/form/configs"
click node_commonfields "https://github.com/jkr0805/flashforte/blob/main/src/app/components/form/configs/commonFields.js"
click node_customform "https://github.com/jkr0805/flashforte/blob/main/src/app/components/form/CustomForm.jsx"
click node_fieldrenderer "https://github.com/jkr0805/flashforte/blob/main/src/app/components/form/FieldRenderer.jsx"
click node_fileupload "https://github.com/jkr0805/flashforte/blob/main/src/app/components/form/FileUpload.jsx"
click node_navbar "https://github.com/jkr0805/flashforte/blob/main/src/app/components/Navbar.jsx"
click node_footer "https://github.com/jkr0805/flashforte/blob/main/src/app/components/Footer.jsx"
click node_imagemodal "https://github.com/jkr0805/flashforte/blob/main/src/app/components/ImageModal.jsx"
click node_cursor "https://github.com/jkr0805/flashforte/blob/main/src/app/components/CursorTrail.jsx"
click node_stars "https://github.com/jkr0805/flashforte/blob/main/src/app/components/StarField.jsx"
click node_countdown "https://github.com/jkr0805/flashforte/blob/main/src/app/components/CountdownTimer.jsx"
click node_loader "https://github.com/jkr0805/flashforte/blob/main/src/app/components/UniversalLoader.jsx"
click node_winners "https://github.com/jkr0805/flashforte/blob/main/src/app/components/WinnersPopup.jsx"

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 toneBlue
class node_landing,node_hero,node_fortes,node_archive,node_highlights,node_schedule toneAmber
class node_ideathon,node_gameathon,node_speakathon,node_designathon toneMint
class node_formpage,node_configs,node_commonfields,node_customform,node_fieldrenderer,node_fileupload toneRose
class node_navbar,node_footer,node_imagemodal,node_cursor,node_stars,node_countdown,node_loader,node_winners,node_participant,node_script toneIndigo
```

## Components

### Portal routing

- [Route shell](https://github.com/jkr0805/flashforte/blob/main/src/app/App.jsx): `src/app/App.jsx`

### Event discovery

- [Landing page](https://github.com/jkr0805/flashforte/blob/main/src/app/pages/LandingPage.jsx): `src/app/pages/LandingPage.jsx`
- [Event hero](https://github.com/jkr0805/flashforte/blob/main/src/app/components/HeroSection.jsx): `src/app/components/HeroSection.jsx`
- [Fortes overview](https://github.com/jkr0805/flashforte/blob/main/src/app/components/ChooseYourReality.jsx): `src/app/components/ChooseYourReality.jsx`
- [Event archive](https://github.com/jkr0805/flashforte/blob/main/src/app/components/RealitiesArchive.jsx): `src/app/components/RealitiesArchive.jsx`
- [Past highlights](https://github.com/jkr0805/flashforte/blob/main/src/app/components/PreviousYearHighlights.jsx): `src/app/components/PreviousYearHighlights.jsx`
- [Schedule cards](https://github.com/jkr0805/flashforte/blob/main/src/app/components/ScheduleCards.jsx): `src/app/components/ScheduleCards.jsx`

### Competition pages

- [Ideathon details](https://github.com/jkr0805/flashforte/blob/main/src/app/pages/IdeaThonPage.jsx): `src/app/pages/IdeaThonPage.jsx`
- [Gameathon details](https://github.com/jkr0805/flashforte/blob/main/src/app/pages/GameAThonPage.jsx): `src/app/pages/GameAThonPage.jsx`
- [Speakathon details](https://github.com/jkr0805/flashforte/blob/main/src/app/pages/SpeakAThonPage.jsx): `src/app/pages/SpeakAThonPage.jsx`
- [Designathon details](https://github.com/jkr0805/flashforte/blob/main/src/app/pages/DesignAThonPage.jsx): `src/app/pages/DesignAThonPage.jsx`

### Participation forms

- [Form page](https://github.com/jkr0805/flashforte/blob/main/src/app/components/form/ForteFormPage.jsx): `src/app/components/form/ForteFormPage.jsx`
- [Event form configs](https://github.com/jkr0805/flashforte/tree/main/src/app/components/form/configs): `src/app/components/form/configs`
- [Common fields](https://github.com/jkr0805/flashforte/blob/main/src/app/components/form/configs/commonFields.js): `src/app/components/form/configs/commonFields.js`
- [Form renderer](https://github.com/jkr0805/flashforte/blob/main/src/app/components/form/CustomForm.jsx): `src/app/components/form/CustomForm.jsx`
- [Field renderer](https://github.com/jkr0805/flashforte/blob/main/src/app/components/form/FieldRenderer.jsx): `src/app/components/form/FieldRenderer.jsx`
- [File upload](https://github.com/jkr0805/flashforte/blob/main/src/app/components/form/FileUpload.jsx): `src/app/components/form/FileUpload.jsx`

### Shared interface

- [Navigation bar](https://github.com/jkr0805/flashforte/blob/main/src/app/components/Navbar.jsx): `src/app/components/Navbar.jsx`
- [Footer](https://github.com/jkr0805/flashforte/blob/main/src/app/components/Footer.jsx): `src/app/components/Footer.jsx`
- [Image modal](https://github.com/jkr0805/flashforte/blob/main/src/app/components/ImageModal.jsx): `src/app/components/ImageModal.jsx`
- [Cursor effect](https://github.com/jkr0805/flashforte/blob/main/src/app/components/CursorTrail.jsx): `src/app/components/CursorTrail.jsx`
- [Star field](https://github.com/jkr0805/flashforte/blob/main/src/app/components/StarField.jsx): `src/app/components/StarField.jsx`
- [Countdown](https://github.com/jkr0805/flashforte/blob/main/src/app/components/CountdownTimer.jsx): `src/app/components/CountdownTimer.jsx`
- [Universal loader](https://github.com/jkr0805/flashforte/blob/main/src/app/components/UniversalLoader.jsx): `src/app/components/UniversalLoader.jsx`
- [Winners popup](https://github.com/jkr0805/flashforte/blob/main/src/app/components/WinnersPopup.jsx): `src/app/components/WinnersPopup.jsx`

### Other components

- **Visitor**
- **Apps Script endpoint**

## Connections

- Visitor → Route shell: opens portal
- Route shell → Landing page: routes to (evidence: `src/app/App.jsx`)
- Route shell → Ideathon details: routes to (evidence: `src/app/App.jsx`)
- Route shell → Gameathon details: routes to (evidence: `src/app/App.jsx`)
- Route shell → Speakathon details: routes to (evidence: `src/app/App.jsx`)
- Route shell → Designathon details: routes to (evidence: `src/app/App.jsx`)
- Route shell → Form page: routes forms (evidence: `src/app/App.jsx`)
- Route shell → Navigation bar: renders (evidence: `src/app/App.jsx`)
- Landing page → Event hero: renders (evidence: `src/app/pages/LandingPage.jsx`)
- Landing page → Fortes overview: renders (evidence: `src/app/pages/LandingPage.jsx`)
- Landing page → Event archive: renders (evidence: `src/app/pages/LandingPage.jsx`)
- Landing page → Past highlights: renders (evidence: `src/app/pages/LandingPage.jsx`)
- Landing page → Schedule cards: renders (evidence: `src/app/pages/LandingPage.jsx`)
- Landing page → Footer: renders (evidence: `src/app/pages/LandingPage.jsx`)
- Event hero → Countdown: renders (evidence: `src/app/components/HeroSection.jsx`)
- Past highlights → Image modal: opens (evidence: `src/app/components/PreviousYearHighlights.jsx`)
- Event archive → Image modal: opens (evidence: `src/app/components/RealitiesArchive.jsx`)
- Ideathon details → Form page: links registration (evidence: `src/app/pages/IdeaThonPage.jsx`)
- Route shell → Event form configs: supplies config (evidence: `src/app/App.jsx`)
- Event form configs → Common fields: uses shared fields (evidence: `src/app/components/form/configs/ideathonConfig.jsx`)
- Form page → Form renderer: renders (evidence: `src/app/components/form/ForteFormPage.jsx`)
- Form renderer → Field renderer: renders fields (evidence: `src/app/components/form/CustomForm.jsx`)
- Form renderer → File upload: renders upload (evidence: `src/app/components/form/CustomForm.jsx`)
- Form renderer → Apps Script endpoint: posts submission (evidence: `src/app/components/form/CustomForm.jsx`)
- Route shell → Footer: renders in forms
- Navigation bar → Winners popup: renders popup (evidence: `src/app/components/Navbar.jsx`)
- Ideathon details → Footer: renders (evidence: `src/app/pages/IdeaThonPage.jsx`)
- Landing page → Cursor effect: renders (evidence: `src/app/pages/LandingPage.jsx`)
- Landing page → Star field: renders (evidence: `src/app/pages/LandingPage.jsx`)
