# soodthin/soodfolio-web architecture

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

- Interactive diagram: https://gitdiagram.com/soodthin/soodfolio-web
- Repository: https://github.com/soodthin/soodfolio-web

## Overview

SoodFolio is a portfolio-building and sharing web app. The main workflow is to authenticate, edit and publish a portfolio in the studio, then share a tailored snapshot and review its viewing telemetry. Public portfolio pages support multiple presentation layouts. The README is only a Next.js starter template, so capabilities and relationships here come mainly from the source index and sampled excerpts; links to unsampled behavior are omitted or marked unverified.

Main entry points: [`components/deck/VerticalStackDeck.tsx`](https://github.com/soodthin/soodfolio-web/blob/main/components/deck/VerticalStackDeck.tsx) (Vertical deck layout), [`lib/apiClient.ts`](https://github.com/soodthin/soodfolio-web/blob/main/lib/apiClient.ts) (Authenticated API client), [`types/portfolio.ts`](https://github.com/soodthin/soodfolio-web/blob/main/types/portfolio.ts) (Portfolio model), [`app/p/[token]/page.tsx`](https://github.com/soodthin/soodfolio-web/blob/main/app/p/%5Btoken%5D/page.tsx) (Shared portfolio)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Discovery and auth"]
  node_landing["Landing experience<br/>[page.tsx]"]
  node_login["Login and registration<br/>[page.tsx]"]
  node_auth_ui["Auth presentation"]
  node_social_auth["Social auth options"]
  node_industry_showcase["Industry showcase"]
end

subgraph group_studio["Portfolio studio"]
  node_dashboard["Portfolio dashboard<br/>[page.tsx]"]
  node_studio_ui["Studio interface<br/>[index.ts]"]
  node_studio_stage["Presentation stage"]
end

subgraph group_publishing["Sharing and analytics"]
  node_links_page["Share-link manager<br/>[page.tsx]"]
  node_create_link["Share-link creation"]
  node_telemetry["Telemetry analytics"]
end

subgraph group_presentation["Public presentation"]
  node_public_portfolio["Public portfolio<br/>[page.tsx]"]
  node_preview["Portfolio preview<br/>[page.tsx]"]
  node_shared_portfolio["Shared portfolio<br/>[page.tsx]"]
  node_deck["Vertical deck layout"]
  node_paper_doc["Minimalist document layout"]
  node_deck_telemetry["Deck telemetry"]
end

subgraph group_foundation["Shared foundations"]
  node_auth_state["Session state<br/>[AuthContext.tsx]"]
  node_auth_storage["Auth session storage<br/>[auth.ts]"]
  node_portfolio_model["Portfolio model<br/>[portfolio.ts]"]
  node_api_client["Authenticated API client<br/>[apiClient.ts]"]
  node_share_model["Share-link model<br/>[shareLink.ts]"]
  node_theme_presets["Theme presets<br/>[themePresets.ts]"]
  node_translations["Localization<br/>[i18n.ts]"]
  node_sound["Sound effects<br/>[sound.ts]"]
end

node_visitor(("Visitor"))
node_backend["Application API"]

node_visitor -.->|"opens"| node_landing
node_visitor -.->|"opens"| node_login
node_landing -->|"renders"| node_industry_showcase
node_login -->|"uses"| node_auth_ui
node_login -->|"uses"| node_social_auth
node_auth_ui -->|"uses"| node_theme_presets
node_auth_ui -->|"uses"| node_translations
node_auth_state -->|"reads and updates"| node_auth_storage
node_dashboard -->|"calls"| node_api_client
node_dashboard -->|"loads"| node_studio_ui
node_dashboard -->|"uses"| node_portfolio_model
node_studio_ui -->|"assembles"| node_studio_stage
node_studio_stage -->|"uses"| node_portfolio_model
node_api_client -->|"sends requests"| node_backend
node_links_page -->|"calls"| node_api_client
node_links_page -->|"opens"| node_create_link
node_links_page -->|"opens"| node_telemetry
node_create_link -->|"calls"| node_api_client
node_telemetry -->|"calls"| node_api_client
node_create_link -->|"uses"| node_share_model
node_telemetry -->|"uses"| node_share_model
node_public_portfolio -->|"renders"| node_deck
node_public_portfolio -->|"uses"| node_portfolio_model
node_preview -->|"renders"| node_deck
node_preview -->|"uses"| node_portfolio_model
node_shared_portfolio -->|"renders"| node_deck
node_shared_portfolio -->|"renders"| node_paper_doc
node_shared_portfolio -->|"uses"| node_deck_telemetry
node_shared_portfolio -->|"uses"| node_share_model
node_deck -->|"uses"| node_theme_presets
node_deck -->|"uses"| node_translations
node_deck -->|"uses"| node_sound
node_paper_doc -->|"uses"| node_portfolio_model

click node_landing "https://github.com/soodthin/soodfolio-web/blob/main/app/page.tsx"
click node_login "https://github.com/soodthin/soodfolio-web/blob/main/app/login/page.tsx"
click node_auth_ui "https://github.com/soodthin/soodfolio-web/blob/main/components/auth/StageGateAuthLayout.tsx"
click node_social_auth "https://github.com/soodthin/soodfolio-web/blob/main/components/auth/SocialAuthButtons.tsx"
click node_auth_state "https://github.com/soodthin/soodfolio-web/blob/main/context/AuthContext.tsx"
click node_auth_storage "https://github.com/soodthin/soodfolio-web/blob/main/lib/auth.ts"
click node_dashboard "https://github.com/soodthin/soodfolio-web/blob/main/app/dashboard/page.tsx"
click node_studio_ui "https://github.com/soodthin/soodfolio-web/blob/main/components/dashboard/studio/index.ts"
click node_studio_stage "https://github.com/soodthin/soodfolio-web/blob/main/components/dashboard/studio/PresentationStage.tsx"
click node_portfolio_model "https://github.com/soodthin/soodfolio-web/blob/main/types/portfolio.ts"
click node_api_client "https://github.com/soodthin/soodfolio-web/blob/main/lib/apiClient.ts"
click node_links_page "https://github.com/soodthin/soodfolio-web/blob/main/app/dashboard/links/page.tsx"
click node_create_link "https://github.com/soodthin/soodfolio-web/blob/main/components/dashboard/CreateShareLinkModal.tsx"
click node_telemetry "https://github.com/soodthin/soodfolio-web/blob/main/components/dashboard/TelemetryHeatmapModal.tsx"
click node_share_model "https://github.com/soodthin/soodfolio-web/blob/main/types/shareLink.ts"
click node_public_portfolio "https://github.com/soodthin/soodfolio-web/blob/main/app/%5Busername%5D/page.tsx"
click node_preview "https://github.com/soodthin/soodfolio-web/blob/main/app/preview/%5Busername%5D/page.tsx"
click node_shared_portfolio "https://github.com/soodthin/soodfolio-web/blob/main/app/p/%5Btoken%5D/page.tsx"
click node_deck "https://github.com/soodthin/soodfolio-web/blob/main/components/deck/VerticalStackDeck.tsx"
click node_paper_doc "https://github.com/soodthin/soodfolio-web/blob/main/components/deck/MinimalistPaperDoc.tsx"
click node_deck_telemetry "https://github.com/soodthin/soodfolio-web/blob/main/hooks/useDeckTelemetry.ts"
click node_theme_presets "https://github.com/soodthin/soodfolio-web/blob/main/lib/themePresets.ts"
click node_translations "https://github.com/soodthin/soodfolio-web/blob/main/lib/i18n.ts"
click node_sound "https://github.com/soodthin/soodfolio-web/blob/main/lib/sound.ts"
click node_industry_showcase "https://github.com/soodthin/soodfolio-web/blob/main/components/home/CrossIndustryShowcase.tsx"

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_landing,node_login,node_auth_ui,node_social_auth,node_industry_showcase toneBlue
class node_dashboard,node_studio_ui,node_studio_stage toneAmber
class node_links_page,node_create_link,node_telemetry,node_backend toneMint
class node_public_portfolio,node_preview,node_shared_portfolio,node_deck,node_paper_doc,node_deck_telemetry toneRose
class node_auth_state,node_auth_storage,node_portfolio_model,node_api_client,node_share_model,node_theme_presets,node_translations,node_sound,node_visitor toneIndigo
```

## Components

### Discovery and auth

- [Landing experience](https://github.com/soodthin/soodfolio-web/blob/main/app/page.tsx): `app/page.tsx`
- [Login and registration](https://github.com/soodthin/soodfolio-web/blob/main/app/login/page.tsx): `app/login/page.tsx`
- [Auth presentation](https://github.com/soodthin/soodfolio-web/blob/main/components/auth/StageGateAuthLayout.tsx): `components/auth/StageGateAuthLayout.tsx`
- [Social auth options](https://github.com/soodthin/soodfolio-web/blob/main/components/auth/SocialAuthButtons.tsx): `components/auth/SocialAuthButtons.tsx`
- [Industry showcase](https://github.com/soodthin/soodfolio-web/blob/main/components/home/CrossIndustryShowcase.tsx): `components/home/CrossIndustryShowcase.tsx`

### Portfolio studio

- [Portfolio dashboard](https://github.com/soodthin/soodfolio-web/blob/main/app/dashboard/page.tsx): `app/dashboard/page.tsx`
- [Studio interface](https://github.com/soodthin/soodfolio-web/blob/main/components/dashboard/studio/index.ts): `components/dashboard/studio/index.ts`
- [Presentation stage](https://github.com/soodthin/soodfolio-web/blob/main/components/dashboard/studio/PresentationStage.tsx): `components/dashboard/studio/PresentationStage.tsx`

### Sharing and analytics

- [Share-link manager](https://github.com/soodthin/soodfolio-web/blob/main/app/dashboard/links/page.tsx): `app/dashboard/links/page.tsx`
- [Share-link creation](https://github.com/soodthin/soodfolio-web/blob/main/components/dashboard/CreateShareLinkModal.tsx): `components/dashboard/CreateShareLinkModal.tsx`
- [Telemetry analytics](https://github.com/soodthin/soodfolio-web/blob/main/components/dashboard/TelemetryHeatmapModal.tsx): `components/dashboard/TelemetryHeatmapModal.tsx`

### Public presentation

- [Public portfolio](https://github.com/soodthin/soodfolio-web/blob/main/app/%5Busername%5D/page.tsx): `app/[username]/page.tsx`
- [Portfolio preview](https://github.com/soodthin/soodfolio-web/blob/main/app/preview/%5Busername%5D/page.tsx): `app/preview/[username]/page.tsx`
- [Shared portfolio](https://github.com/soodthin/soodfolio-web/blob/main/app/p/%5Btoken%5D/page.tsx): `app/p/[token]/page.tsx`
- [Vertical deck layout](https://github.com/soodthin/soodfolio-web/blob/main/components/deck/VerticalStackDeck.tsx): `components/deck/VerticalStackDeck.tsx`
- [Minimalist document layout](https://github.com/soodthin/soodfolio-web/blob/main/components/deck/MinimalistPaperDoc.tsx): `components/deck/MinimalistPaperDoc.tsx`
- [Deck telemetry](https://github.com/soodthin/soodfolio-web/blob/main/hooks/useDeckTelemetry.ts): `hooks/useDeckTelemetry.ts`

### Shared foundations

- [Session state](https://github.com/soodthin/soodfolio-web/blob/main/context/AuthContext.tsx): `context/AuthContext.tsx`
- [Auth session storage](https://github.com/soodthin/soodfolio-web/blob/main/lib/auth.ts): `lib/auth.ts`
- [Portfolio model](https://github.com/soodthin/soodfolio-web/blob/main/types/portfolio.ts): `types/portfolio.ts`
- [Authenticated API client](https://github.com/soodthin/soodfolio-web/blob/main/lib/apiClient.ts): `lib/apiClient.ts`
- [Share-link model](https://github.com/soodthin/soodfolio-web/blob/main/types/shareLink.ts): `types/shareLink.ts`
- [Theme presets](https://github.com/soodthin/soodfolio-web/blob/main/lib/themePresets.ts): `lib/themePresets.ts`
- [Localization](https://github.com/soodthin/soodfolio-web/blob/main/lib/i18n.ts): `lib/i18n.ts`
- [Sound effects](https://github.com/soodthin/soodfolio-web/blob/main/lib/sound.ts): `lib/sound.ts`

### Other components

- **Visitor**
- **Application API**

## Connections

- Visitor → Landing experience: opens
- Visitor → Login and registration: opens
- Landing experience → Industry showcase: renders (evidence: `app/page.tsx`)
- Login and registration → Auth presentation: uses (evidence: `app/login/page.tsx`)
- Login and registration → Social auth options: uses (evidence: `app/login/page.tsx`)
- Auth presentation → Theme presets: uses (evidence: `components/auth/StageGateAuthLayout.tsx`)
- Auth presentation → Localization: uses (evidence: `components/auth/StageGateAuthLayout.tsx`)
- Session state → Auth session storage: reads and updates (evidence: `context/AuthContext.tsx`)
- Portfolio dashboard → Authenticated API client: calls (evidence: `app/dashboard/page.tsx`)
- Portfolio dashboard → Studio interface: loads (evidence: `app/dashboard/page.tsx`)
- Portfolio dashboard → Portfolio model: uses (evidence: `app/dashboard/page.tsx`)
- Studio interface → Presentation stage: assembles (evidence: `components/dashboard/studio/index.ts`)
- Presentation stage → Portfolio model: uses (evidence: `components/dashboard/studio/PresentationStage.tsx`)
- Authenticated API client → Application API: sends requests (evidence: `lib/apiClient.ts`)
- Share-link manager → Authenticated API client: calls (evidence: `app/dashboard/links/page.tsx`)
- Share-link manager → Share-link creation: opens (evidence: `app/dashboard/links/page.tsx`)
- Share-link manager → Telemetry analytics: opens (evidence: `app/dashboard/links/page.tsx`)
- Share-link creation → Authenticated API client: calls (evidence: `components/dashboard/CreateShareLinkModal.tsx`)
- Telemetry analytics → Authenticated API client: calls (evidence: `components/dashboard/TelemetryHeatmapModal.tsx`)
- Share-link creation → Share-link model: uses (evidence: `components/dashboard/CreateShareLinkModal.tsx`)
- Telemetry analytics → Share-link model: uses (evidence: `components/dashboard/TelemetryHeatmapModal.tsx`)
- Public portfolio → Vertical deck layout: renders (evidence: `app/[username]/page.tsx`)
- Public portfolio → Portfolio model: uses (evidence: `app/[username]/page.tsx`)
- Portfolio preview → Vertical deck layout: renders (evidence: `app/preview/[username]/page.tsx`)
- Portfolio preview → Portfolio model: uses (evidence: `app/preview/[username]/page.tsx`)
- Shared portfolio → Vertical deck layout: renders (evidence: `app/p/[token]/page.tsx`)
- Shared portfolio → Minimalist document layout: renders (evidence: `app/p/[token]/page.tsx`)
- Shared portfolio → Deck telemetry: uses (evidence: `app/p/[token]/page.tsx`)
- Shared portfolio → Share-link model: uses (evidence: `app/p/[token]/page.tsx`)
- Vertical deck layout → Theme presets: uses (evidence: `components/deck/VerticalStackDeck.tsx`)
- Vertical deck layout → Localization: uses (evidence: `components/deck/VerticalStackDeck.tsx`)
- Vertical deck layout → Sound effects: uses (evidence: `components/deck/VerticalStackDeck.tsx`)
- Minimalist document layout → Portfolio model: uses (evidence: `components/deck/MinimalistPaperDoc.tsx`)
