# prof7turtle/project-binarybrains architecture

> Architecture diagram of the GitHub repository prof7turtle/project-binarybrains, 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/prof7turtle/project-binarybrains
- Repository: https://github.com/prof7turtle/project-binarybrains

## Overview

BinaryBrains is a student tech-community website presenting its team, events, hackathon, sponsors, gallery, and contact information. The browser entry point mounts the React app, whose router selects a page; several pages compose a shared layout and visual backgrounds. The contact page also contains a message form, but the excerpt does not establish its submission destination. The backend entry point is present, though its sampled source gives no evidence of its behavior or connection to the frontend.

Main entry points: [`frontend/src/App.tsx`](https://github.com/prof7turtle/project-binarybrains/blob/main/frontend/src/App.tsx) (Router and providers), [`frontend/src/components/layout/Layout.tsx`](https://github.com/prof7turtle/project-binarybrains/blob/main/frontend/src/components/layout/Layout.tsx) (Page layout), [`frontend/src/pages/Events.tsx`](https://github.com/prof7turtle/project-binarybrains/blob/main/frontend/src/pages/Events.tsx) (Events page), [`frontend/src/pages/Gallery.tsx`](https://github.com/prof7turtle/project-binarybrains/blob/main/frontend/src/pages/Gallery.tsx) (Gallery page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_application["Application shell"]
  node_entry["Browser entry<br/>[main.tsx]"]
  node_app["Router and providers<br/>[App.tsx]"]
end

subgraph group_community["Community pages"]
  node_home["Home page<br/>[Index.tsx]"]
  node_about["About page<br/>[About.tsx]"]
  node_team["Team page<br/>[Team.tsx]"]
  node_events["Events page<br/>[Events.tsx]"]
  node_hackathon["Hackathon page<br/>[Hackathon.tsx]"]
  node_sponsors["Sponsors page<br/>[Sponsors.tsx]"]
  node_gallery["Gallery page<br/>[Gallery.tsx]"]
  node_contact["Contact page<br/>[Contact.tsx]"]
  node_notfound["Not-found page<br/>[NotFound.tsx]"]
  node_homehero["Home hero<br/>[HeroSection.tsx]"]
  node_features["Home features"]
  node_hackathoncta["Hackathon callout<br/>[HackathonCTA.tsx]"]
end

subgraph group_presentation["Shared presentation"]
  node_layout["Page layout<br/>[Layout.tsx]"]
  node_navbar["Navigation<br/>[Navbar.tsx]"]
  node_footer["Footer<br/>[Footer.tsx]"]
  node_aurora["Aurora effect<br/>[Aurora.tsx]"]
  node_lightrays["Light-ray effect<br/>[LightRays.tsx]"]
end

subgraph group_backend["Backend"]
  node_server["Backend server<br/>[server.js]"]
end

node_visitor(("Site visitor"))

node_visitor -->|"opens site"| node_entry
node_entry -->|"mounts"| node_app
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_about
node_app -->|"routes to"| node_team
node_app -->|"routes to"| node_events
node_app -->|"routes to"| node_hackathon
node_app -->|"routes to"| node_sponsors
node_app -->|"routes to"| node_gallery
node_app -->|"routes to"| node_contact
node_app -->|"routes to"| node_notfound
node_layout -->|"renders"| node_navbar
node_layout -->|"renders"| node_footer
node_homehero -->|"renders"| node_aurora
node_events -->|"renders"| node_layout
node_events -->|"renders"| node_lightrays
node_hackathon -->|"renders"| node_layout
node_gallery -->|"renders"| node_layout
node_gallery -->|"renders"| node_lightrays
node_contact -->|"renders"| node_layout
node_contact -->|"renders"| node_lightrays

click node_entry "https://github.com/prof7turtle/project-binarybrains/blob/main/frontend/src/main.tsx"
click node_app "https://github.com/prof7turtle/project-binarybrains/blob/main/frontend/src/App.tsx"
click node_home "https://github.com/prof7turtle/project-binarybrains/blob/main/frontend/src/pages/Index.tsx"
click node_about "https://github.com/prof7turtle/project-binarybrains/blob/main/frontend/src/pages/About.tsx"
click node_team "https://github.com/prof7turtle/project-binarybrains/blob/main/frontend/src/pages/Team.tsx"
click node_events "https://github.com/prof7turtle/project-binarybrains/blob/main/frontend/src/pages/Events.tsx"
click node_hackathon "https://github.com/prof7turtle/project-binarybrains/blob/main/frontend/src/pages/Hackathon.tsx"
click node_sponsors "https://github.com/prof7turtle/project-binarybrains/blob/main/frontend/src/pages/Sponsors.tsx"
click node_gallery "https://github.com/prof7turtle/project-binarybrains/blob/main/frontend/src/pages/Gallery.tsx"
click node_contact "https://github.com/prof7turtle/project-binarybrains/blob/main/frontend/src/pages/Contact.tsx"
click node_notfound "https://github.com/prof7turtle/project-binarybrains/blob/main/frontend/src/pages/NotFound.tsx"
click node_homehero "https://github.com/prof7turtle/project-binarybrains/blob/main/frontend/src/components/home/HeroSection.tsx"
click node_layout "https://github.com/prof7turtle/project-binarybrains/blob/main/frontend/src/components/layout/Layout.tsx"
click node_navbar "https://github.com/prof7turtle/project-binarybrains/blob/main/frontend/src/components/layout/Navbar.tsx"
click node_footer "https://github.com/prof7turtle/project-binarybrains/blob/main/frontend/src/components/layout/Footer.tsx"
click node_aurora "https://github.com/prof7turtle/project-binarybrains/blob/main/frontend/src/components/Aurora.tsx"
click node_lightrays "https://github.com/prof7turtle/project-binarybrains/blob/main/frontend/src/components/LightRays.tsx"
click node_features "https://github.com/prof7turtle/project-binarybrains/blob/main/frontend/src/components/home/FeaturesSection.tsx"
click node_hackathoncta "https://github.com/prof7turtle/project-binarybrains/blob/main/frontend/src/components/home/HackathonCTA.tsx"
click node_server "https://github.com/prof7turtle/project-binarybrains/blob/main/backend/src/server.js"

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_entry,node_app toneBlue
class node_home,node_about,node_team,node_events,node_hackathon,node_sponsors,node_gallery,node_contact,node_notfound,node_homehero,node_features,node_hackathoncta toneAmber
class node_layout,node_navbar,node_footer,node_aurora,node_lightrays toneMint
class node_server toneRose
class node_visitor toneIndigo
```

## Components

### Application shell

- [Browser entry](https://github.com/prof7turtle/project-binarybrains/blob/main/frontend/src/main.tsx): `frontend/src/main.tsx`
- [Router and providers](https://github.com/prof7turtle/project-binarybrains/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`

### Community pages

- [Home page](https://github.com/prof7turtle/project-binarybrains/blob/main/frontend/src/pages/Index.tsx): `frontend/src/pages/Index.tsx`
- [About page](https://github.com/prof7turtle/project-binarybrains/blob/main/frontend/src/pages/About.tsx): `frontend/src/pages/About.tsx`
- [Team page](https://github.com/prof7turtle/project-binarybrains/blob/main/frontend/src/pages/Team.tsx): `frontend/src/pages/Team.tsx`
- [Events page](https://github.com/prof7turtle/project-binarybrains/blob/main/frontend/src/pages/Events.tsx): `frontend/src/pages/Events.tsx`
- [Hackathon page](https://github.com/prof7turtle/project-binarybrains/blob/main/frontend/src/pages/Hackathon.tsx): `frontend/src/pages/Hackathon.tsx`
- [Sponsors page](https://github.com/prof7turtle/project-binarybrains/blob/main/frontend/src/pages/Sponsors.tsx): `frontend/src/pages/Sponsors.tsx`
- [Gallery page](https://github.com/prof7turtle/project-binarybrains/blob/main/frontend/src/pages/Gallery.tsx): `frontend/src/pages/Gallery.tsx`
- [Contact page](https://github.com/prof7turtle/project-binarybrains/blob/main/frontend/src/pages/Contact.tsx): `frontend/src/pages/Contact.tsx`
- [Not-found page](https://github.com/prof7turtle/project-binarybrains/blob/main/frontend/src/pages/NotFound.tsx): `frontend/src/pages/NotFound.tsx`
- [Home hero](https://github.com/prof7turtle/project-binarybrains/blob/main/frontend/src/components/home/HeroSection.tsx): `frontend/src/components/home/HeroSection.tsx`
- [Home features](https://github.com/prof7turtle/project-binarybrains/blob/main/frontend/src/components/home/FeaturesSection.tsx): `frontend/src/components/home/FeaturesSection.tsx`
- [Hackathon callout](https://github.com/prof7turtle/project-binarybrains/blob/main/frontend/src/components/home/HackathonCTA.tsx): `frontend/src/components/home/HackathonCTA.tsx`

### Shared presentation

- [Page layout](https://github.com/prof7turtle/project-binarybrains/blob/main/frontend/src/components/layout/Layout.tsx): `frontend/src/components/layout/Layout.tsx`
- [Navigation](https://github.com/prof7turtle/project-binarybrains/blob/main/frontend/src/components/layout/Navbar.tsx): `frontend/src/components/layout/Navbar.tsx`
- [Footer](https://github.com/prof7turtle/project-binarybrains/blob/main/frontend/src/components/layout/Footer.tsx): `frontend/src/components/layout/Footer.tsx`
- [Aurora effect](https://github.com/prof7turtle/project-binarybrains/blob/main/frontend/src/components/Aurora.tsx): `frontend/src/components/Aurora.tsx`
- [Light-ray effect](https://github.com/prof7turtle/project-binarybrains/blob/main/frontend/src/components/LightRays.tsx): `frontend/src/components/LightRays.tsx`

### Backend

- [Backend server](https://github.com/prof7turtle/project-binarybrains/blob/main/backend/src/server.js): `backend/src/server.js`

### Other components

- **Site visitor**

## Connections

- Site visitor → Browser entry: opens site (evidence: `README.md`)
- Browser entry → Router and providers: mounts (evidence: `frontend/src/main.tsx`)
- Router and providers → Home page: routes to (evidence: `frontend/src/App.tsx`)
- Router and providers → About page: routes to (evidence: `frontend/src/App.tsx`)
- Router and providers → Team page: routes to (evidence: `frontend/src/App.tsx`)
- Router and providers → Events page: routes to (evidence: `frontend/src/App.tsx`)
- Router and providers → Hackathon page: routes to (evidence: `frontend/src/App.tsx`)
- Router and providers → Sponsors page: routes to (evidence: `frontend/src/App.tsx`)
- Router and providers → Gallery page: routes to (evidence: `frontend/src/App.tsx`)
- Router and providers → Contact page: routes to (evidence: `frontend/src/App.tsx`)
- Router and providers → Not-found page: routes to (evidence: `frontend/src/App.tsx`)
- Page layout → Navigation: renders (evidence: `frontend/src/components/layout/Layout.tsx`)
- Page layout → Footer: renders (evidence: `frontend/src/components/layout/Layout.tsx`)
- Home hero → Aurora effect: renders (evidence: `frontend/src/components/home/HeroSection.tsx`)
- Events page → Page layout: renders (evidence: `frontend/src/pages/Events.tsx`)
- Events page → Light-ray effect: renders (evidence: `frontend/src/pages/Events.tsx`)
- Hackathon page → Page layout: renders (evidence: `frontend/src/pages/Hackathon.tsx`)
- Gallery page → Page layout: renders (evidence: `frontend/src/pages/Gallery.tsx`)
- Gallery page → Light-ray effect: renders (evidence: `frontend/src/pages/Gallery.tsx`)
- Contact page → Page layout: renders (evidence: `frontend/src/pages/Contact.tsx`)
- Contact page → Light-ray effect: renders (evidence: `frontend/src/pages/Contact.tsx`)
