# iyasz/elaina-dev architecture

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

- Interactive diagram: https://gitdiagram.com/iyasz/elaina-dev
- Repository: https://github.com/iyasz/elaina-dev

## Overview

Elaina is a developer portfolio: a visitor requests the site, TanStack Start serves the app, and routing renders the portfolio’s home page with its hero, profile, and navigation. The page also includes GSAP hero animation and a profile-photo drop interaction. The repository contains a broad reusable UI primitive set; the graph highlights its documented UI layer and central sidebar dependencies. Error capture and fallback rendering form a separate server reliability path. Unsampled modules are represented only where the tree or README supports their role; optional framework runtime wiring is dashed.

Main entry points: [`src/components/ui/sidebar.tsx`](https://github.com/iyasz/elaina-dev/blob/master/src/components/ui/sidebar.tsx) (Sidebar system), [`src/server.ts`](https://github.com/iyasz/elaina-dev/blob/master/src/server.ts) (Server entry), [`src/routes/index.tsx`](https://github.com/iyasz/elaina-dev/blob/master/src/routes/index.tsx) (Portfolio page), [`src/lib/utils.ts`](https://github.com/iyasz/elaina-dev/blob/master/src/lib/utils.ts) (Class utilities)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Portfolio experience"]
  node_home["Portfolio page<br/>[index.tsx]"]
  node_gsap["GSAP animation"]
end

subgraph group_routing["Routing and server"]
  node_server["Server entry<br/>[server.ts]"]
  node_start["Start instance<br/>[start.ts]"]
  node_framework["TanStack runtime"]
  node_router["Router setup<br/>[router.tsx]"]
  node_route_tree["Route tree<br/>[routeTree.gen.ts]"]
  node_root["Root layout<br/>[__root.tsx]"]
end

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

subgraph group_errors["Error handling"]
  node_error_capture["Error capture<br/>[error-capture.ts]"]
  node_error_page["Error page renderer<br/>[error-page.ts]"]
end

node_visitor(("Site visitor"))
node_iyasz["Iyasz site"]

node_visitor -.->|"requests page"| node_server
node_server -->|"dispatches fetch"| node_framework
node_framework -.->|"loads app router"| node_router
node_router -->|"registers routes"| node_route_tree
node_route_tree -->|"registers root"| node_root
node_route_tree -->|"registers home"| node_home
node_root -->|"renders outlet"| node_home
node_home -->|"animates hero"| node_gsap
node_home -->|"links externally"| node_iyasz
node_server -->|"consumes captured error"| node_error_capture
node_server -->|"renders fallback"| node_error_page
node_start -->|"uses fallback"| node_error_page
node_sidebar -->|"checks breakpoint"| node_mobile_hook
node_sidebar -->|"renders mobile panel"| node_sheet
node_sidebar -->|"renders menu tooltip"| node_tooltip
node_sidebar -->|"renders trigger"| node_button
node_sidebar -->|"merges classes"| node_utils
node_button -->|"merges classes"| node_utils
node_dialog -->|"merges classes"| node_utils
node_chart -->|"merges classes"| node_utils

click node_server "https://github.com/iyasz/elaina-dev/blob/master/src/server.ts"
click node_start "https://github.com/iyasz/elaina-dev/blob/master/src/start.ts"
click node_router "https://github.com/iyasz/elaina-dev/blob/master/src/router.tsx"
click node_route_tree "https://github.com/iyasz/elaina-dev/blob/master/src/routeTree.gen.ts"
click node_root "https://github.com/iyasz/elaina-dev/blob/master/src/routes/__root.tsx"
click node_home "https://github.com/iyasz/elaina-dev/blob/master/src/routes/index.tsx"
click node_ui_primitives "https://github.com/iyasz/elaina-dev/tree/master/src/components/ui"
click node_button "https://github.com/iyasz/elaina-dev/blob/master/src/components/ui/button.tsx"
click node_dialog "https://github.com/iyasz/elaina-dev/blob/master/src/components/ui/dialog.tsx"
click node_chart "https://github.com/iyasz/elaina-dev/blob/master/src/components/ui/chart.tsx"
click node_sidebar "https://github.com/iyasz/elaina-dev/blob/master/src/components/ui/sidebar.tsx"
click node_mobile_hook "https://github.com/iyasz/elaina-dev/blob/master/src/hooks/use-mobile.tsx"
click node_sheet "https://github.com/iyasz/elaina-dev/blob/master/src/components/ui/sheet.tsx"
click node_tooltip "https://github.com/iyasz/elaina-dev/blob/master/src/components/ui/tooltip.tsx"
click node_utils "https://github.com/iyasz/elaina-dev/blob/master/src/lib/utils.ts"
click node_error_capture "https://github.com/iyasz/elaina-dev/blob/master/src/lib/error-capture.ts"
click node_error_page "https://github.com/iyasz/elaina-dev/blob/master/src/lib/error-page.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_home,node_gsap toneBlue
class node_server,node_start,node_framework,node_router,node_route_tree,node_root toneAmber
class node_ui_primitives,node_button,node_dialog,node_chart,node_sidebar,node_mobile_hook,node_sheet,node_tooltip,node_utils toneMint
class node_error_capture,node_error_page toneRose
class node_visitor,node_iyasz toneIndigo
```

## Components

### Portfolio experience

- [Portfolio page](https://github.com/iyasz/elaina-dev/blob/master/src/routes/index.tsx): `src/routes/index.tsx`
- **GSAP animation**

### Routing and server

- [Server entry](https://github.com/iyasz/elaina-dev/blob/master/src/server.ts): `src/server.ts`
- [Start instance](https://github.com/iyasz/elaina-dev/blob/master/src/start.ts): `src/start.ts`
- **TanStack runtime**
- [Router setup](https://github.com/iyasz/elaina-dev/blob/master/src/router.tsx): `src/router.tsx`
- [Route tree](https://github.com/iyasz/elaina-dev/blob/master/src/routeTree.gen.ts): `src/routeTree.gen.ts`
- [Root layout](https://github.com/iyasz/elaina-dev/blob/master/src/routes/__root.tsx): `src/routes/__root.tsx`

### Reusable UI

- [UI primitives](https://github.com/iyasz/elaina-dev/tree/master/src/components/ui): `src/components/ui`
- [Button primitive](https://github.com/iyasz/elaina-dev/blob/master/src/components/ui/button.tsx): `src/components/ui/button.tsx`
- [Dialog primitive](https://github.com/iyasz/elaina-dev/blob/master/src/components/ui/dialog.tsx): `src/components/ui/dialog.tsx`
- [Chart primitive](https://github.com/iyasz/elaina-dev/blob/master/src/components/ui/chart.tsx): `src/components/ui/chart.tsx`
- [Sidebar system](https://github.com/iyasz/elaina-dev/blob/master/src/components/ui/sidebar.tsx): `src/components/ui/sidebar.tsx`
- [Mobile breakpoint hook](https://github.com/iyasz/elaina-dev/blob/master/src/hooks/use-mobile.tsx): `src/hooks/use-mobile.tsx`
- [Sheet primitive](https://github.com/iyasz/elaina-dev/blob/master/src/components/ui/sheet.tsx): `src/components/ui/sheet.tsx`
- [Tooltip primitive](https://github.com/iyasz/elaina-dev/blob/master/src/components/ui/tooltip.tsx): `src/components/ui/tooltip.tsx`
- [Class utilities](https://github.com/iyasz/elaina-dev/blob/master/src/lib/utils.ts): `src/lib/utils.ts`

### Error handling

- [Error capture](https://github.com/iyasz/elaina-dev/blob/master/src/lib/error-capture.ts): `src/lib/error-capture.ts`
- [Error page renderer](https://github.com/iyasz/elaina-dev/blob/master/src/lib/error-page.ts): `src/lib/error-page.ts`

### Other components

- **Site visitor**
- **Iyasz site**

## Connections

- Site visitor → Server entry: requests page
- Server entry → TanStack runtime: dispatches fetch (evidence: `src/server.ts`)
- TanStack runtime → Router setup: loads app router
- Router setup → Route tree: registers routes (evidence: `src/router.tsx`)
- Route tree → Root layout: registers root (evidence: `src/routeTree.gen.ts`)
- Route tree → Portfolio page: registers home (evidence: `src/routeTree.gen.ts`)
- Root layout → Portfolio page: renders outlet (evidence: `src/routes/__root.tsx`)
- Portfolio page → GSAP animation: animates hero (evidence: `src/routes/index.tsx`)
- Portfolio page → Iyasz site: links externally (evidence: `src/routes/index.tsx`)
- Server entry → Error capture: consumes captured error (evidence: `src/server.ts`)
- Server entry → Error page renderer: renders fallback (evidence: `src/server.ts`)
- Start instance → Error page renderer: uses fallback (evidence: `src/start.ts`)
- Sidebar system → Mobile breakpoint hook: checks breakpoint (evidence: `src/components/ui/sidebar.tsx`)
- Sidebar system → Sheet primitive: renders mobile panel (evidence: `src/components/ui/sidebar.tsx`)
- Sidebar system → Tooltip primitive: renders menu tooltip (evidence: `src/components/ui/sidebar.tsx`)
- Sidebar system → Button primitive: renders trigger (evidence: `src/components/ui/sidebar.tsx`)
- Sidebar system → Class utilities: merges classes (evidence: `src/components/ui/sidebar.tsx`)
- Button primitive → Class utilities: merges classes (evidence: `src/components/ui/button.tsx`)
- Dialog primitive → Class utilities: merges classes (evidence: `src/components/ui/dialog.tsx`)
- Chart primitive → Class utilities: merges classes (evidence: `src/components/ui/chart.tsx`)
