# kartik192008/portfolio-x-kartik- architecture

> Architecture diagram of the GitHub repository kartik192008/portfolio-x-kartik-, 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/kartik192008/portfolio-x-kartik-
- Repository: https://github.com/kartik192008/portfolio-x-kartik-

## Overview

This workspace contains a portfolio site, a component-preview sandbox, a small HTTP API server, and shared API/database libraries. The portfolio workflow is a visitor browsing the home, work, toolkit, lab, and contact experience; the sandbox workflow is opening a preview path and rendering a dynamically loaded component. The API starts an Express app and routes API requests to health handling. No README was provided, and the API server and libraries are not shown wired together, so those connections are omitted.

Main entry points: [`artifacts/kartik-portfolio/src/main.tsx`](https://github.com/kartik192008/portfolio-x-kartik-/blob/main/artifacts/kartik-portfolio/src/main.tsx) (Portfolio mount), [`artifacts/api-server/src/index.ts`](https://github.com/kartik192008/portfolio-x-kartik-/blob/main/artifacts/api-server/src/index.ts) (API listener), [`artifacts/api-server/src/app.ts`](https://github.com/kartik192008/portfolio-x-kartik-/blob/main/artifacts/api-server/src/app.ts) (Express app), [`lib/db/src/index.ts`](https://github.com/kartik192008/portfolio-x-kartik-/blob/main/lib/db/src/index.ts) (Drizzle database)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_portfolio["Portfolio site"]
  node_portfolio_mount["Portfolio mount<br/>[main.tsx]"]
  node_portfolio_app["Portfolio experience<br/>[App.tsx]"]
  node_portfolio_errors["Error boundary<br/>[error-boundary.tsx]"]
end

subgraph group_sandbox["Component previews"]
  node_sandbox_mount["Sandbox mount<br/>[main.tsx]"]
  node_sandbox_app["Preview router<br/>[App.tsx]"]
  node_preview_plugin["Preview discovery"]
end

subgraph group_server["HTTP API"]
  node_api_listener["API listener<br/>[index.ts]"]
  node_api_app["Express app<br/>[app.ts]"]
  node_api_routes["API routes<br/>[index.ts]"]
  node_health_route["Health route<br/>[health.ts]"]
  node_logger["Request logger<br/>[logger.ts]"]
end

subgraph group_shared["Shared libraries"]
  node_fetch_client["Custom fetch<br/>[custom-fetch.ts]"]
  node_db_client["Drizzle database<br/>[index.ts]"]
  node_db_schema["Database schema<br/>[index.ts]"]
  node_zod_exports["API Zod exports<br/>[index.ts]"]
end

node_visitor(("Visitor"))
node_api_caller(("API caller"))
node_postgres[("PostgreSQL")]

node_visitor -->|"opens site"| node_portfolio_mount
node_portfolio_mount -->|"renders"| node_portfolio_app
node_portfolio_mount -->|"wraps"| node_portfolio_errors
node_visitor -->|"opens sandbox"| node_sandbox_mount
node_sandbox_mount -->|"renders"| node_sandbox_app
node_api_caller -->|"sends request"| node_api_listener
node_api_listener -->|"starts"| node_api_app
node_api_app -->|"mounts at /api"| node_api_routes
node_api_routes -->|"registers"| node_health_route
node_api_app -->|"configures logging"| node_logger
node_api_listener -->|"logs startup"| node_logger
node_db_client -->|"loads schema"| node_db_schema
node_db_client -->|"connects to"| node_postgres

click node_portfolio_mount "https://github.com/kartik192008/portfolio-x-kartik-/blob/main/artifacts/kartik-portfolio/src/main.tsx"
click node_portfolio_app "https://github.com/kartik192008/portfolio-x-kartik-/blob/main/artifacts/kartik-portfolio/src/App.tsx"
click node_portfolio_errors "https://github.com/kartik192008/portfolio-x-kartik-/blob/main/artifacts/kartik-portfolio/src/components/error-boundary.tsx"
click node_sandbox_mount "https://github.com/kartik192008/portfolio-x-kartik-/blob/main/artifacts/mockup-sandbox/src/main.tsx"
click node_sandbox_app "https://github.com/kartik192008/portfolio-x-kartik-/blob/main/artifacts/mockup-sandbox/src/App.tsx"
click node_preview_plugin "https://github.com/kartik192008/portfolio-x-kartik-/blob/main/artifacts/mockup-sandbox/mockupPreviewPlugin.ts"
click node_api_listener "https://github.com/kartik192008/portfolio-x-kartik-/blob/main/artifacts/api-server/src/index.ts"
click node_api_app "https://github.com/kartik192008/portfolio-x-kartik-/blob/main/artifacts/api-server/src/app.ts"
click node_api_routes "https://github.com/kartik192008/portfolio-x-kartik-/blob/main/artifacts/api-server/src/routes/index.ts"
click node_health_route "https://github.com/kartik192008/portfolio-x-kartik-/blob/main/artifacts/api-server/src/routes/health.ts"
click node_logger "https://github.com/kartik192008/portfolio-x-kartik-/blob/main/artifacts/api-server/src/lib/logger.ts"
click node_fetch_client "https://github.com/kartik192008/portfolio-x-kartik-/blob/main/lib/api-client-react/src/custom-fetch.ts"
click node_db_client "https://github.com/kartik192008/portfolio-x-kartik-/blob/main/lib/db/src/index.ts"
click node_db_schema "https://github.com/kartik192008/portfolio-x-kartik-/blob/main/lib/db/src/schema/index.ts"
click node_zod_exports "https://github.com/kartik192008/portfolio-x-kartik-/blob/main/lib/api-zod/src/index.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_mount,node_portfolio_app,node_portfolio_errors toneBlue
class node_sandbox_mount,node_sandbox_app,node_preview_plugin,node_postgres toneAmber
class node_api_listener,node_api_app,node_api_routes,node_health_route,node_logger,node_api_caller toneMint
class node_fetch_client,node_db_client,node_db_schema,node_zod_exports toneRose
class node_visitor toneIndigo
```

## Components

### Portfolio site

- [Portfolio mount](https://github.com/kartik192008/portfolio-x-kartik-/blob/main/artifacts/kartik-portfolio/src/main.tsx): `artifacts/kartik-portfolio/src/main.tsx`
- [Portfolio experience](https://github.com/kartik192008/portfolio-x-kartik-/blob/main/artifacts/kartik-portfolio/src/App.tsx): `artifacts/kartik-portfolio/src/App.tsx`
- [Error boundary](https://github.com/kartik192008/portfolio-x-kartik-/blob/main/artifacts/kartik-portfolio/src/components/error-boundary.tsx): `artifacts/kartik-portfolio/src/components/error-boundary.tsx`

### Component previews

- [Sandbox mount](https://github.com/kartik192008/portfolio-x-kartik-/blob/main/artifacts/mockup-sandbox/src/main.tsx): `artifacts/mockup-sandbox/src/main.tsx`
- [Preview router](https://github.com/kartik192008/portfolio-x-kartik-/blob/main/artifacts/mockup-sandbox/src/App.tsx): `artifacts/mockup-sandbox/src/App.tsx`
- [Preview discovery](https://github.com/kartik192008/portfolio-x-kartik-/blob/main/artifacts/mockup-sandbox/mockupPreviewPlugin.ts): `artifacts/mockup-sandbox/mockupPreviewPlugin.ts`

### HTTP API

- [API listener](https://github.com/kartik192008/portfolio-x-kartik-/blob/main/artifacts/api-server/src/index.ts): `artifacts/api-server/src/index.ts`
- [Express app](https://github.com/kartik192008/portfolio-x-kartik-/blob/main/artifacts/api-server/src/app.ts): `artifacts/api-server/src/app.ts`
- [API routes](https://github.com/kartik192008/portfolio-x-kartik-/blob/main/artifacts/api-server/src/routes/index.ts): `artifacts/api-server/src/routes/index.ts`
- [Health route](https://github.com/kartik192008/portfolio-x-kartik-/blob/main/artifacts/api-server/src/routes/health.ts): `artifacts/api-server/src/routes/health.ts`
- [Request logger](https://github.com/kartik192008/portfolio-x-kartik-/blob/main/artifacts/api-server/src/lib/logger.ts): `artifacts/api-server/src/lib/logger.ts`

### Shared libraries

- [Custom fetch](https://github.com/kartik192008/portfolio-x-kartik-/blob/main/lib/api-client-react/src/custom-fetch.ts): `lib/api-client-react/src/custom-fetch.ts`
- [Drizzle database](https://github.com/kartik192008/portfolio-x-kartik-/blob/main/lib/db/src/index.ts): `lib/db/src/index.ts`
- [Database schema](https://github.com/kartik192008/portfolio-x-kartik-/blob/main/lib/db/src/schema/index.ts): `lib/db/src/schema/index.ts`
- [API Zod exports](https://github.com/kartik192008/portfolio-x-kartik-/blob/main/lib/api-zod/src/index.ts): `lib/api-zod/src/index.ts`

### Other components

- **Visitor**
- **API caller**
- **PostgreSQL**

## Connections

- Visitor → Portfolio mount: opens site
- Portfolio mount → Portfolio experience: renders (evidence: `artifacts/kartik-portfolio/src/main.tsx`)
- Portfolio mount → Error boundary: wraps (evidence: `artifacts/kartik-portfolio/src/main.tsx`)
- Visitor → Sandbox mount: opens sandbox
- Sandbox mount → Preview router: renders (evidence: `artifacts/mockup-sandbox/src/main.tsx`)
- API caller → API listener: sends request
- API listener → Express app: starts (evidence: `artifacts/api-server/src/index.ts`)
- Express app → API routes: mounts at /api (evidence: `artifacts/api-server/src/app.ts`)
- API routes → Health route: registers (evidence: `artifacts/api-server/src/routes/index.ts`)
- Express app → Request logger: configures logging (evidence: `artifacts/api-server/src/app.ts`)
- API listener → Request logger: logs startup (evidence: `artifacts/api-server/src/index.ts`)
- Drizzle database → Database schema: loads schema (evidence: `lib/db/src/index.ts`)
- Drizzle database → PostgreSQL: connects to (evidence: `lib/db/src/index.ts`)
