# shyxmmmmmm/flux-vanguard architecture

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

- Interactive diagram: https://gitdiagram.com/shyxmmmmmm/flux-vanguard
- Repository: https://github.com/shyxmmmmmm/flux-vanguard

## Overview

This is a personal developer portfolio: visitors browse an introduction, biography, skills, profiles, and project showcases, with contact and resume links as conversion points. The request path enters the server-rendered app, whose router selects a page; the root supplies shared navigation and visual framing. Project and other page implementations are included even where excerpts are unavailable, based on the source index. Those references establish route registration and imports, but not unsampled page behavior.

Main entry points: [`src/routeTree.gen.ts`](https://github.com/shyxmmmmmm/flux-vanguard/blob/main/src/routeTree.gen.ts) (Route registry), [`src/components/PageTransition.tsx`](https://github.com/shyxmmmmmm/flux-vanguard/blob/main/src/components/PageTransition.tsx) (Page transitions), [`src/components/ui/sidebar.tsx`](https://github.com/shyxmmmmmm/flux-vanguard/blob/main/src/components/ui/sidebar.tsx) (Sidebar components), [`src/routes/__root.tsx`](https://github.com/shyxmmmmmm/flux-vanguard/blob/main/src/routes/__root.tsx) (Shared app shell)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Web runtime"]
  node_server["Request server<br/>[server.ts]"]
  node_router["App router<br/>[router.tsx]"]
  node_route_tree["Route registry<br/>[routeTree.gen.ts]"]
  node_root["Shared app shell<br/>[__root.tsx]"]
  node_error_capture["Error capture<br/>[error-capture.ts]"]
  node_error_page["Fallback error page<br/>[error-page.ts]"]
end

subgraph group_pages["Portfolio pages"]
  node_home["Home and introduction<br/>[index.tsx]"]
  node_about["About page<br/>[about.tsx]"]
  node_contact["Contact page<br/>[contact.tsx]"]
  node_profiles["Profiles page<br/>[profiles.tsx]"]
  node_projects["Projects showcase<br/>[projects.tsx]"]
  node_skills["Skills page<br/>[skills.tsx]"]
  node_sitemap["XML sitemap<br/>[sitemap&#91;.&#93;xml.ts]"]
end

subgraph group_shared["Shared presentation"]
  node_navbar["Navigation and theme<br/>[Navbar.tsx]"]
  node_footer["Footer<br/>[Footer.tsx]"]
  node_particles["Particle backdrop"]
  node_blobs["Background blobs"]
  node_transition["Page transitions<br/>[PageTransition.tsx]"]
  node_hero3d["3D hero visual<br/>[Hero3D.tsx]"]
end

subgraph group_ui["Reusable UI"]
  node_sidebar["Sidebar components<br/>[sidebar.tsx]"]
  node_mobile_hook["Mobile breakpoint hook<br/>[use-mobile.tsx]"]
  node_sheet["Sheet primitives<br/>[sheet.tsx]"]
  node_tooltip["Tooltip primitives<br/>[tooltip.tsx]"]
  node_button["Button primitive<br/>[button.tsx]"]
  node_utils["Class utilities<br/>[utils.ts]"]
end

node_visitor(("Visitor"))
node_serverentry["TanStack server entry"]
node_resume["Resume file"]
node_project_links["Project demo and code sites"]

node_visitor -->|"sends request"| node_server
node_server -->|"dispatches to"| node_serverentry
node_server -->|"consumes captured error"| node_error_capture
node_server -->|"renders fallback"| node_error_page
node_router -->|"uses route tree"| node_route_tree
node_route_tree -->|"registers route"| node_root
node_route_tree -->|"registers route"| node_home
node_route_tree -->|"registers route"| node_about
node_route_tree -->|"registers route"| node_contact
node_route_tree -->|"registers route"| node_profiles
node_route_tree -->|"registers route"| node_projects
node_route_tree -->|"registers route"| node_skills
node_route_tree -->|"registers route"| node_sitemap
node_root -->|"renders"| node_navbar
node_root -->|"renders"| node_footer
node_root -->|"renders"| node_particles
node_root -->|"renders"| node_blobs
node_home -->|"wraps page"| node_transition
node_home -->|"renders"| node_hero3d
node_about -->|"uses transition"| node_transition
node_contact -->|"uses transition"| node_transition
node_profiles -->|"uses transition"| node_transition
node_projects -->|"uses transition"| node_transition
node_skills -->|"uses transition"| node_transition
node_home -->|"links to download"| node_resume
node_projects -->|"links to demos and code"| node_project_links
node_sidebar -->|"checks breakpoint"| node_mobile_hook
node_sidebar -->|"uses on mobile"| node_sheet
node_sidebar -->|"uses tooltips"| node_tooltip
node_sidebar -->|"uses buttons"| node_button
node_sidebar -->|"uses class helper"| node_utils

click node_server "https://github.com/shyxmmmmmm/flux-vanguard/blob/main/src/server.ts"
click node_router "https://github.com/shyxmmmmmm/flux-vanguard/blob/main/src/router.tsx"
click node_route_tree "https://github.com/shyxmmmmmm/flux-vanguard/blob/main/src/routeTree.gen.ts"
click node_root "https://github.com/shyxmmmmmm/flux-vanguard/blob/main/src/routes/__root.tsx"
click node_error_capture "https://github.com/shyxmmmmmm/flux-vanguard/blob/main/src/lib/error-capture.ts"
click node_error_page "https://github.com/shyxmmmmmm/flux-vanguard/blob/main/src/lib/error-page.ts"
click node_home "https://github.com/shyxmmmmmm/flux-vanguard/blob/main/src/routes/index.tsx"
click node_about "https://github.com/shyxmmmmmm/flux-vanguard/blob/main/src/routes/about.tsx"
click node_contact "https://github.com/shyxmmmmmm/flux-vanguard/blob/main/src/routes/contact.tsx"
click node_profiles "https://github.com/shyxmmmmmm/flux-vanguard/blob/main/src/routes/profiles.tsx"
click node_projects "https://github.com/shyxmmmmmm/flux-vanguard/blob/main/src/routes/projects.tsx"
click node_skills "https://github.com/shyxmmmmmm/flux-vanguard/blob/main/src/routes/skills.tsx"
click node_sitemap "https://github.com/shyxmmmmmm/flux-vanguard/blob/main/src/routes/sitemap%5B.%5Dxml.ts"
click node_navbar "https://github.com/shyxmmmmmm/flux-vanguard/blob/main/src/components/Navbar.tsx"
click node_footer "https://github.com/shyxmmmmmm/flux-vanguard/blob/main/src/components/Footer.tsx"
click node_particles "https://github.com/shyxmmmmmm/flux-vanguard/blob/main/src/components/ParticlesBackground.tsx"
click node_blobs "https://github.com/shyxmmmmmm/flux-vanguard/blob/main/src/components/BackgroundBlobs.tsx"
click node_transition "https://github.com/shyxmmmmmm/flux-vanguard/blob/main/src/components/PageTransition.tsx"
click node_hero3d "https://github.com/shyxmmmmmm/flux-vanguard/blob/main/src/components/Hero3D.tsx"
click node_sidebar "https://github.com/shyxmmmmmm/flux-vanguard/blob/main/src/components/ui/sidebar.tsx"
click node_mobile_hook "https://github.com/shyxmmmmmm/flux-vanguard/blob/main/src/hooks/use-mobile.tsx"
click node_sheet "https://github.com/shyxmmmmmm/flux-vanguard/blob/main/src/components/ui/sheet.tsx"
click node_tooltip "https://github.com/shyxmmmmmm/flux-vanguard/blob/main/src/components/ui/tooltip.tsx"
click node_button "https://github.com/shyxmmmmmm/flux-vanguard/blob/main/src/components/ui/button.tsx"
click node_utils "https://github.com/shyxmmmmmm/flux-vanguard/blob/main/src/lib/utils.ts"

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_server,node_router,node_route_tree,node_root,node_error_capture,node_error_page toneBlue
class node_home,node_about,node_contact,node_profiles,node_projects,node_skills,node_sitemap toneAmber
class node_navbar,node_footer,node_particles,node_blobs,node_transition,node_hero3d,node_serverentry toneMint
class node_sidebar,node_mobile_hook,node_sheet,node_tooltip,node_button,node_utils toneRose
class node_visitor,node_resume,node_project_links toneIndigo
```

## Components

### Web runtime

- [Request server](https://github.com/shyxmmmmmm/flux-vanguard/blob/main/src/server.ts): `src/server.ts`
- [App router](https://github.com/shyxmmmmmm/flux-vanguard/blob/main/src/router.tsx): `src/router.tsx`
- [Route registry](https://github.com/shyxmmmmmm/flux-vanguard/blob/main/src/routeTree.gen.ts): `src/routeTree.gen.ts`
- [Shared app shell](https://github.com/shyxmmmmmm/flux-vanguard/blob/main/src/routes/__root.tsx): `src/routes/__root.tsx`
- [Error capture](https://github.com/shyxmmmmmm/flux-vanguard/blob/main/src/lib/error-capture.ts): `src/lib/error-capture.ts`
- [Fallback error page](https://github.com/shyxmmmmmm/flux-vanguard/blob/main/src/lib/error-page.ts): `src/lib/error-page.ts`

### Portfolio pages

- [Home and introduction](https://github.com/shyxmmmmmm/flux-vanguard/blob/main/src/routes/index.tsx): `src/routes/index.tsx`
- [About page](https://github.com/shyxmmmmmm/flux-vanguard/blob/main/src/routes/about.tsx): `src/routes/about.tsx`
- [Contact page](https://github.com/shyxmmmmmm/flux-vanguard/blob/main/src/routes/contact.tsx): `src/routes/contact.tsx`
- [Profiles page](https://github.com/shyxmmmmmm/flux-vanguard/blob/main/src/routes/profiles.tsx): `src/routes/profiles.tsx`
- [Projects showcase](https://github.com/shyxmmmmmm/flux-vanguard/blob/main/src/routes/projects.tsx): `src/routes/projects.tsx`
- [Skills page](https://github.com/shyxmmmmmm/flux-vanguard/blob/main/src/routes/skills.tsx): `src/routes/skills.tsx`
- [XML sitemap](https://github.com/shyxmmmmmm/flux-vanguard/blob/main/src/routes/sitemap%5B.%5Dxml.ts): `src/routes/sitemap[.]xml.ts`

### Shared presentation

- [Navigation and theme](https://github.com/shyxmmmmmm/flux-vanguard/blob/main/src/components/Navbar.tsx): `src/components/Navbar.tsx`
- [Footer](https://github.com/shyxmmmmmm/flux-vanguard/blob/main/src/components/Footer.tsx): `src/components/Footer.tsx`
- [Particle backdrop](https://github.com/shyxmmmmmm/flux-vanguard/blob/main/src/components/ParticlesBackground.tsx): `src/components/ParticlesBackground.tsx`
- [Background blobs](https://github.com/shyxmmmmmm/flux-vanguard/blob/main/src/components/BackgroundBlobs.tsx): `src/components/BackgroundBlobs.tsx`
- [Page transitions](https://github.com/shyxmmmmmm/flux-vanguard/blob/main/src/components/PageTransition.tsx): `src/components/PageTransition.tsx`
- [3D hero visual](https://github.com/shyxmmmmmm/flux-vanguard/blob/main/src/components/Hero3D.tsx): `src/components/Hero3D.tsx`

### Reusable UI

- [Sidebar components](https://github.com/shyxmmmmmm/flux-vanguard/blob/main/src/components/ui/sidebar.tsx): `src/components/ui/sidebar.tsx`
- [Mobile breakpoint hook](https://github.com/shyxmmmmmm/flux-vanguard/blob/main/src/hooks/use-mobile.tsx): `src/hooks/use-mobile.tsx`
- [Sheet primitives](https://github.com/shyxmmmmmm/flux-vanguard/blob/main/src/components/ui/sheet.tsx): `src/components/ui/sheet.tsx`
- [Tooltip primitives](https://github.com/shyxmmmmmm/flux-vanguard/blob/main/src/components/ui/tooltip.tsx): `src/components/ui/tooltip.tsx`
- [Button primitive](https://github.com/shyxmmmmmm/flux-vanguard/blob/main/src/components/ui/button.tsx): `src/components/ui/button.tsx`
- [Class utilities](https://github.com/shyxmmmmmm/flux-vanguard/blob/main/src/lib/utils.ts): `src/lib/utils.ts`

### Other components

- **Visitor**
- **TanStack server entry**
- **Resume file**
- **Project demo and code sites**

## Connections

- Visitor → Request server: sends request (evidence: `src/server.ts`)
- Request server → TanStack server entry: dispatches to (evidence: `src/server.ts`)
- Request server → Error capture: consumes captured error (evidence: `src/server.ts`)
- Request server → Fallback error page: renders fallback (evidence: `src/server.ts`)
- App router → Route registry: uses route tree (evidence: `src/router.tsx`)
- Route registry → Shared app shell: registers route (evidence: `src/routeTree.gen.ts`)
- Route registry → Home and introduction: registers route (evidence: `src/routeTree.gen.ts`)
- Route registry → About page: registers route (evidence: `src/routeTree.gen.ts`)
- Route registry → Contact page: registers route (evidence: `src/routeTree.gen.ts`)
- Route registry → Profiles page: registers route (evidence: `src/routeTree.gen.ts`)
- Route registry → Projects showcase: registers route (evidence: `src/routeTree.gen.ts`)
- Route registry → Skills page: registers route (evidence: `src/routeTree.gen.ts`)
- Route registry → XML sitemap: registers route (evidence: `src/routeTree.gen.ts`)
- Shared app shell → Navigation and theme: renders (evidence: `src/routes/__root.tsx`)
- Shared app shell → Footer: renders (evidence: `src/routes/__root.tsx`)
- Shared app shell → Particle backdrop: renders (evidence: `src/routes/__root.tsx`)
- Shared app shell → Background blobs: renders (evidence: `src/routes/__root.tsx`)
- Home and introduction → Page transitions: wraps page (evidence: `src/routes/index.tsx`)
- Home and introduction → 3D hero visual: renders (evidence: `src/routes/index.tsx`)
- About page → Page transitions: uses transition (evidence: `src/routes/about.tsx`)
- Contact page → Page transitions: uses transition (evidence: `src/routes/contact.tsx`)
- Profiles page → Page transitions: uses transition (evidence: `src/routes/profiles.tsx`)
- Projects showcase → Page transitions: uses transition (evidence: `src/routes/projects.tsx`)
- Skills page → Page transitions: uses transition (evidence: `src/routes/skills.tsx`)
- Home and introduction → Resume file: links to download (evidence: `src/routes/index.tsx`)
- Projects showcase → Project demo and code sites: links to demos and code (evidence: `src/routes/projects.tsx`)
- Sidebar components → Mobile breakpoint hook: checks breakpoint (evidence: `src/components/ui/sidebar.tsx`)
- Sidebar components → Sheet primitives: uses on mobile (evidence: `src/components/ui/sidebar.tsx`)
- Sidebar components → Tooltip primitives: uses tooltips (evidence: `src/components/ui/sidebar.tsx`)
- Sidebar components → Button primitive: uses buttons (evidence: `src/components/ui/sidebar.tsx`)
- Sidebar components → Class utilities: uses class helper (evidence: `src/components/ui/sidebar.tsx`)
