# mudavath-kumar/new-portfolio architecture

> Architecture diagram of the GitHub repository mudavath-kumar/new-portfolio, 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/mudavath-kumar/new-portfolio
- Repository: https://github.com/mudavath-kumar/new-portfolio

## Overview

This is a single-page personal portfolio presenting projects, certifications, career information, and contact options. Visitors browse the editorial portfolio, view credentials and project links, access the résumé, or submit a message through Formspree. The route and SSR setup support delivery; server-side error handling is a separate operational layer. The README documents theme switching, responsive design, cursor effects, and animated reveals, while sampled source confirms the main page, cursor, contact submission, routing, and error handling. Several documented presentation features are implemented in unsampled portions of the page, so their internal wiring is not expanded here.

Main entry points: [`src/routes/index.tsx`](https://github.com/mudavath-kumar/new-portfolio/blob/main/src/routes/index.tsx) (Portfolio page), [`src/routeTree.gen.ts`](https://github.com/mudavath-kumar/new-portfolio/blob/main/src/routeTree.gen.ts) (Route tree), [`src/server.ts`](https://github.com/mudavath-kumar/new-portfolio/blob/main/src/server.ts) (SSR server entry), [`src/components/ui/sidebar.tsx`](https://github.com/mudavath-kumar/new-portfolio/blob/main/src/components/ui/sidebar.tsx) (Responsive sidebar)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_portfolio["Portfolio experience"]
  node_portfolio_page["Portfolio page<br/>[index.tsx]"]
  node_projects["Featured projects<br/>[index.tsx]"]
  node_credentials["Certifications<br/>[index.tsx]"]
  node_resume["Résumé access<br/>[index.tsx]"]
  node_contact["Contact form<br/>[index.tsx]"]
  node_cursor["Smooth cursor<br/>[smooth-cursor.tsx]"]
end

subgraph group_runtime["Routing and rendering"]
  node_router["Router setup<br/>[router.tsx]"]
  node_route_tree["Route tree<br/>[routeTree.gen.ts]"]
  node_root_route["Root route<br/>[__root.tsx]"]
  node_start["Start configuration<br/>[start.ts]"]
  node_server["SSR server entry<br/>[server.ts]"]
end

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

subgraph group_ui["Reusable UI"]
  node_ui_primitives["UI primitives"]
  node_sidebar["Responsive sidebar<br/>[sidebar.tsx]"]
  node_mobile_hook["Mobile breakpoint hook<br/>[use-mobile.tsx]"]
  node_utils["Class utilities<br/>[utils.ts]"]
end

node_visitor(("Visitor"))
node_formspree["Formspree"]

node_visitor -.->|"opens portfolio"| node_router
node_router -->|"uses routes"| node_route_tree
node_route_tree -->|"registers root"| node_root_route
node_route_tree -->|"registers home"| node_portfolio_page
node_portfolio_page -->|"renders"| node_cursor
node_portfolio_page -->|"presents"| node_projects
node_portfolio_page -->|"presents"| node_credentials
node_portfolio_page -->|"links résumé"| node_resume
node_portfolio_page -->|"hosts"| node_contact
node_contact -->|"submits message"| node_formspree
node_root_route -->|"reports errors"| node_lovable_reporting
node_server -->|"captures errors"| node_error_capture
node_server -->|"renders fallback"| node_error_page
node_sidebar -->|"checks breakpoint"| node_mobile_hook
node_sidebar -->|"uses components"| node_ui_primitives
node_ui_primitives -.->|"merges classes"| node_utils

click node_portfolio_page "https://github.com/mudavath-kumar/new-portfolio/blob/main/src/routes/index.tsx"
click node_projects "https://github.com/mudavath-kumar/new-portfolio/blob/main/src/routes/index.tsx"
click node_credentials "https://github.com/mudavath-kumar/new-portfolio/blob/main/src/routes/index.tsx"
click node_resume "https://github.com/mudavath-kumar/new-portfolio/blob/main/src/routes/index.tsx"
click node_contact "https://github.com/mudavath-kumar/new-portfolio/blob/main/src/routes/index.tsx"
click node_cursor "https://github.com/mudavath-kumar/new-portfolio/blob/main/src/registry/magicui/smooth-cursor.tsx"
click node_router "https://github.com/mudavath-kumar/new-portfolio/blob/main/src/router.tsx"
click node_route_tree "https://github.com/mudavath-kumar/new-portfolio/blob/main/src/routeTree.gen.ts"
click node_root_route "https://github.com/mudavath-kumar/new-portfolio/blob/main/src/routes/__root.tsx"
click node_start "https://github.com/mudavath-kumar/new-portfolio/blob/main/src/start.ts"
click node_server "https://github.com/mudavath-kumar/new-portfolio/blob/main/src/server.ts"
click node_error_capture "https://github.com/mudavath-kumar/new-portfolio/blob/main/src/lib/error-capture.ts"
click node_error_page "https://github.com/mudavath-kumar/new-portfolio/blob/main/src/lib/error-page.ts"
click node_lovable_reporting "https://github.com/mudavath-kumar/new-portfolio/blob/main/src/lib/lovable-error-reporting.ts"
click node_ui_primitives "https://github.com/mudavath-kumar/new-portfolio/tree/main/src/components/ui"
click node_sidebar "https://github.com/mudavath-kumar/new-portfolio/blob/main/src/components/ui/sidebar.tsx"
click node_mobile_hook "https://github.com/mudavath-kumar/new-portfolio/blob/main/src/hooks/use-mobile.tsx"
click node_utils "https://github.com/mudavath-kumar/new-portfolio/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_portfolio_page,node_projects,node_credentials,node_resume,node_contact,node_cursor toneBlue
class node_router,node_route_tree,node_root_route,node_start,node_server toneAmber
class node_error_capture,node_error_page,node_lovable_reporting toneMint
class node_ui_primitives,node_sidebar,node_mobile_hook,node_utils toneRose
class node_visitor,node_formspree toneIndigo
```

## Components

### Portfolio experience

- [Portfolio page](https://github.com/mudavath-kumar/new-portfolio/blob/main/src/routes/index.tsx): `src/routes/index.tsx`
- [Featured projects](https://github.com/mudavath-kumar/new-portfolio/blob/main/src/routes/index.tsx): `src/routes/index.tsx`
- [Certifications](https://github.com/mudavath-kumar/new-portfolio/blob/main/src/routes/index.tsx): `src/routes/index.tsx`
- [Résumé access](https://github.com/mudavath-kumar/new-portfolio/blob/main/src/routes/index.tsx): `src/routes/index.tsx`
- [Contact form](https://github.com/mudavath-kumar/new-portfolio/blob/main/src/routes/index.tsx): `src/routes/index.tsx`
- [Smooth cursor](https://github.com/mudavath-kumar/new-portfolio/blob/main/src/registry/magicui/smooth-cursor.tsx): `src/registry/magicui/smooth-cursor.tsx`

### Routing and rendering

- [Router setup](https://github.com/mudavath-kumar/new-portfolio/blob/main/src/router.tsx): `src/router.tsx`
- [Route tree](https://github.com/mudavath-kumar/new-portfolio/blob/main/src/routeTree.gen.ts): `src/routeTree.gen.ts`
- [Root route](https://github.com/mudavath-kumar/new-portfolio/blob/main/src/routes/__root.tsx): `src/routes/__root.tsx`
- [Start configuration](https://github.com/mudavath-kumar/new-portfolio/blob/main/src/start.ts): `src/start.ts`
- [SSR server entry](https://github.com/mudavath-kumar/new-portfolio/blob/main/src/server.ts): `src/server.ts`

### Error handling

- [Error capture](https://github.com/mudavath-kumar/new-portfolio/blob/main/src/lib/error-capture.ts): `src/lib/error-capture.ts`
- [Error response page](https://github.com/mudavath-kumar/new-portfolio/blob/main/src/lib/error-page.ts): `src/lib/error-page.ts`
- [Client error reporting](https://github.com/mudavath-kumar/new-portfolio/blob/main/src/lib/lovable-error-reporting.ts): `src/lib/lovable-error-reporting.ts`

### Reusable UI

- [UI primitives](https://github.com/mudavath-kumar/new-portfolio/tree/main/src/components/ui): `src/components/ui`
- [Responsive sidebar](https://github.com/mudavath-kumar/new-portfolio/blob/main/src/components/ui/sidebar.tsx): `src/components/ui/sidebar.tsx`
- [Mobile breakpoint hook](https://github.com/mudavath-kumar/new-portfolio/blob/main/src/hooks/use-mobile.tsx): `src/hooks/use-mobile.tsx`
- [Class utilities](https://github.com/mudavath-kumar/new-portfolio/blob/main/src/lib/utils.ts): `src/lib/utils.ts`

### Other components

- **Visitor**
- **Formspree**

## Connections

- Visitor → Router setup: opens portfolio
- Router setup → Route tree: uses routes (evidence: `src/router.tsx`)
- Route tree → Root route: registers root (evidence: `src/routeTree.gen.ts`)
- Route tree → Portfolio page: registers home (evidence: `src/routeTree.gen.ts`)
- Portfolio page → Smooth cursor: renders (evidence: `src/routes/index.tsx`)
- Portfolio page → Featured projects: presents (evidence: `src/routes/index.tsx`)
- Portfolio page → Certifications: presents (evidence: `src/routes/index.tsx`)
- Portfolio page → Résumé access: links résumé (evidence: `src/routes/index.tsx`)
- Portfolio page → Contact form: hosts (evidence: `src/routes/index.tsx`)
- Contact form → Formspree: submits message (evidence: `src/routes/index.tsx`)
- Root route → Client error reporting: reports errors (evidence: `src/routes/__root.tsx`)
- SSR server entry → Error capture: captures errors (evidence: `src/server.ts`)
- SSR server entry → Error response page: renders fallback (evidence: `src/server.ts`)
- Responsive sidebar → Mobile breakpoint hook: checks breakpoint (evidence: `src/components/ui/sidebar.tsx`)
- Responsive sidebar → UI primitives: uses components (evidence: `src/components/ui/sidebar.tsx`)
- UI primitives → Class utilities: merges classes (evidence: `src/components/ui/context-menu.tsx`)
