# tim-ny/portfolio architecture

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

- Interactive diagram: https://gitdiagram.com/tim-ny/portfolio
- Repository: https://github.com/tim-ny/portfolio

## Overview

This is a content-driven personal portfolio: visitors browse the homepage’s profile, career timeline, skills, and projects, or open standalone content pages; they can also download a resume or start an email. Nuxt Content collections supply the site data, while composables fetch and sort structured collections for the views. The README documents the content categories and theme persistence; the excerpts show the main routes, fetch calls, and theme behavior. The mobile navigation implementation and content files were not sampled, so their internal behavior is not inferred.

Main entry points: [`app/pages/index.vue`](https://github.com/tim-ny/portfolio/blob/main/app/pages/index.vue) (Portfolio home), [`content.config.ts`](https://github.com/tim-ny/portfolio/blob/main/content.config.ts) (Typed collections), [`app/pages/[...slug].vue`](https://github.com/tim-ny/portfolio/blob/main/app/pages/%5B...slug%5D.vue) (Standalone pages), [`app/components/SiteSidebar.vue`](https://github.com/tim-ny/portfolio/blob/main/app/components/SiteSidebar.vue) (Sidebar)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_routes["Routes and presentation"]
  node_home["Portfolio home<br/>[index.vue]"]
  node_standalone["Standalone pages<br/>[&#91;...slug&#93;.vue]"]
  node_app_shell["App shell<br/>[app.vue]"]
  node_sidebar["Sidebar<br/>[SiteSidebar.vue]"]
  node_mobile_nav["Mobile navigation<br/>[MobileNav.vue]"]
  node_ambient["Ambient backdrop"]
end

subgraph group_content["Portfolio content"]
  node_settings["Site settings<br/>[useSiteSettings.ts]"]
  node_experience["Experience data<br/>[useExperience.ts]"]
  node_skills["Skills data<br/>[useSkills.ts]"]
  node_projects["Project data<br/>[useProjects.ts]"]
  node_socials["Social links<br/>[useSocials.ts]"]
  node_page_data["Page content<br/>[&#91;...slug&#93;.vue]"]
  node_collection_schema["Typed collections<br/>[content.config.ts]"]
  node_site_files["Site profile files<br/>[site.yml]"]
  node_experience_files["Career entries"]
  node_skill_files["Skill groups"]
  node_project_files["Project entries"]
  node_social_files["Social entries"]
  node_pages_files["Markdown pages"]
end

subgraph group_interactions["Visitor interactions"]
  node_effects["Portfolio effects"]
  node_theme["Theme state<br/>[useTheme.ts]"]
  node_theme_css["Theme styles<br/>[main.css]"]
  node_resume["Resume download<br/>[resume.pdf]"]
end

node_visitor(("Visitor"))
node_browser_storage[("Browser local storage")]
node_email_app(("Visitor email app"))

node_visitor -->|"opens"| node_home
node_visitor -->|"opens"| node_standalone
node_home -->|"renders within"| node_app_shell
node_standalone -->|"renders within"| node_app_shell
node_home -->|"fetches"| node_settings
node_home -->|"fetches"| node_experience
node_home -->|"fetches"| node_skills
node_home -->|"fetches"| node_projects
node_home -->|"queries"| node_page_data
node_home -->|"renders"| node_mobile_nav
node_home -->|"renders"| node_sidebar
node_home -->|"renders"| node_ambient
node_home -->|"initializes"| node_effects
node_standalone -->|"renders"| node_mobile_nav
node_standalone -->|"renders"| node_sidebar
node_standalone -->|"renders"| node_ambient
node_standalone -->|"queries"| node_page_data
node_sidebar -->|"fetches"| node_settings
node_sidebar -->|"fetches"| node_socials
node_sidebar -->|"uses"| node_theme
node_theme -->|"persists theme"| node_browser_storage
node_theme -->|"sets theme attribute"| node_theme_css
node_settings -->|"queries site"| node_collection_schema
node_experience -->|"queries experience"| node_collection_schema
node_skills -->|"queries skills"| node_collection_schema
node_projects -->|"queries projects"| node_collection_schema
node_socials -->|"queries socials"| node_collection_schema
node_page_data -->|"queries pages"| node_collection_schema
node_collection_schema -->|"defines source"| node_site_files
node_collection_schema -->|"defines source"| node_experience_files
node_collection_schema -->|"defines source"| node_skill_files
node_collection_schema -->|"defines source"| node_project_files
node_collection_schema -->|"defines source"| node_social_files
node_collection_schema -->|"defines source"| node_pages_files
node_home -->|"opens mailto"| node_email_app
node_visitor -->|"downloads"| node_resume

click node_home "https://github.com/tim-ny/portfolio/blob/main/app/pages/index.vue"
click node_standalone "https://github.com/tim-ny/portfolio/blob/main/app/pages/%5B...slug%5D.vue"
click node_app_shell "https://github.com/tim-ny/portfolio/blob/main/app/app.vue"
click node_sidebar "https://github.com/tim-ny/portfolio/blob/main/app/components/SiteSidebar.vue"
click node_mobile_nav "https://github.com/tim-ny/portfolio/blob/main/app/components/MobileNav.vue"
click node_ambient "https://github.com/tim-ny/portfolio/blob/main/app/components/AmbientBackground.vue"
click node_effects "https://github.com/tim-ny/portfolio/blob/main/app/composables/usePortfolioEffects.ts"
click node_settings "https://github.com/tim-ny/portfolio/blob/main/app/composables/useSiteSettings.ts"
click node_experience "https://github.com/tim-ny/portfolio/blob/main/app/composables/useExperience.ts"
click node_skills "https://github.com/tim-ny/portfolio/blob/main/app/composables/useSkills.ts"
click node_projects "https://github.com/tim-ny/portfolio/blob/main/app/composables/useProjects.ts"
click node_socials "https://github.com/tim-ny/portfolio/blob/main/app/composables/useSocials.ts"
click node_page_data "https://github.com/tim-ny/portfolio/blob/main/app/pages/%5B...slug%5D.vue"
click node_collection_schema "https://github.com/tim-ny/portfolio/blob/main/content.config.ts"
click node_site_files "https://github.com/tim-ny/portfolio/blob/main/content/site.yml"
click node_experience_files "https://github.com/tim-ny/portfolio/tree/main/content/experience"
click node_skill_files "https://github.com/tim-ny/portfolio/tree/main/content/skills"
click node_project_files "https://github.com/tim-ny/portfolio/tree/main/content/projects"
click node_social_files "https://github.com/tim-ny/portfolio/tree/main/content/socials"
click node_pages_files "https://github.com/tim-ny/portfolio/tree/main/content/pages"
click node_theme "https://github.com/tim-ny/portfolio/blob/main/app/composables/useTheme.ts"
click node_theme_css "https://github.com/tim-ny/portfolio/blob/main/app/assets/css/main.css"
click node_resume "https://github.com/tim-ny/portfolio/blob/main/public/resume.pdf"

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_standalone,node_app_shell,node_sidebar,node_mobile_nav,node_ambient toneBlue
class node_settings,node_experience,node_skills,node_projects,node_socials,node_page_data,node_collection_schema,node_site_files,node_experience_files,node_skill_files,node_project_files,node_social_files,node_pages_files,node_browser_storage toneAmber
class node_effects,node_theme,node_theme_css,node_resume toneMint
class node_visitor,node_email_app toneIndigo
```

## Components

### Routes and presentation

- [Portfolio home](https://github.com/tim-ny/portfolio/blob/main/app/pages/index.vue): `app/pages/index.vue`
- [Standalone pages](https://github.com/tim-ny/portfolio/blob/main/app/pages/%5B...slug%5D.vue): `app/pages/[...slug].vue`
- [App shell](https://github.com/tim-ny/portfolio/blob/main/app/app.vue): `app/app.vue`
- [Sidebar](https://github.com/tim-ny/portfolio/blob/main/app/components/SiteSidebar.vue): `app/components/SiteSidebar.vue`
- [Mobile navigation](https://github.com/tim-ny/portfolio/blob/main/app/components/MobileNav.vue): `app/components/MobileNav.vue`
- [Ambient backdrop](https://github.com/tim-ny/portfolio/blob/main/app/components/AmbientBackground.vue): `app/components/AmbientBackground.vue`

### Portfolio content

- [Site settings](https://github.com/tim-ny/portfolio/blob/main/app/composables/useSiteSettings.ts): `app/composables/useSiteSettings.ts`
- [Experience data](https://github.com/tim-ny/portfolio/blob/main/app/composables/useExperience.ts): `app/composables/useExperience.ts`
- [Skills data](https://github.com/tim-ny/portfolio/blob/main/app/composables/useSkills.ts): `app/composables/useSkills.ts`
- [Project data](https://github.com/tim-ny/portfolio/blob/main/app/composables/useProjects.ts): `app/composables/useProjects.ts`
- [Social links](https://github.com/tim-ny/portfolio/blob/main/app/composables/useSocials.ts): `app/composables/useSocials.ts`
- [Page content](https://github.com/tim-ny/portfolio/blob/main/app/pages/%5B...slug%5D.vue): `app/pages/[...slug].vue`
- [Typed collections](https://github.com/tim-ny/portfolio/blob/main/content.config.ts): `content.config.ts`
- [Site profile files](https://github.com/tim-ny/portfolio/blob/main/content/site.yml): `content/site.yml`
- [Career entries](https://github.com/tim-ny/portfolio/tree/main/content/experience): `content/experience`
- [Skill groups](https://github.com/tim-ny/portfolio/tree/main/content/skills): `content/skills`
- [Project entries](https://github.com/tim-ny/portfolio/tree/main/content/projects): `content/projects`
- [Social entries](https://github.com/tim-ny/portfolio/tree/main/content/socials): `content/socials`
- [Markdown pages](https://github.com/tim-ny/portfolio/tree/main/content/pages): `content/pages`

### Visitor interactions

- [Portfolio effects](https://github.com/tim-ny/portfolio/blob/main/app/composables/usePortfolioEffects.ts): `app/composables/usePortfolioEffects.ts`
- [Theme state](https://github.com/tim-ny/portfolio/blob/main/app/composables/useTheme.ts): `app/composables/useTheme.ts`
- [Theme styles](https://github.com/tim-ny/portfolio/blob/main/app/assets/css/main.css): `app/assets/css/main.css`
- [Resume download](https://github.com/tim-ny/portfolio/blob/main/public/resume.pdf): `public/resume.pdf`

### Other components

- **Visitor**
- **Browser local storage**
- **Visitor email app**

## Connections

- Visitor → Portfolio home: opens (evidence: `app/pages/index.vue`)
- Visitor → Standalone pages: opens (evidence: `app/pages/[...slug].vue`)
- Portfolio home → App shell: renders within (evidence: `app/app.vue`)
- Standalone pages → App shell: renders within (evidence: `app/app.vue`)
- Portfolio home → Site settings: fetches (evidence: `app/pages/index.vue`)
- Portfolio home → Experience data: fetches (evidence: `app/pages/index.vue`)
- Portfolio home → Skills data: fetches (evidence: `app/pages/index.vue`)
- Portfolio home → Project data: fetches (evidence: `app/pages/index.vue`)
- Portfolio home → Page content: queries (evidence: `app/pages/index.vue`)
- Portfolio home → Mobile navigation: renders (evidence: `app/pages/index.vue`)
- Portfolio home → Sidebar: renders (evidence: `app/pages/index.vue`)
- Portfolio home → Ambient backdrop: renders (evidence: `app/pages/index.vue`)
- Portfolio home → Portfolio effects: initializes (evidence: `app/pages/index.vue`)
- Standalone pages → Mobile navigation: renders (evidence: `app/pages/[...slug].vue`)
- Standalone pages → Sidebar: renders (evidence: `app/pages/[...slug].vue`)
- Standalone pages → Ambient backdrop: renders (evidence: `app/pages/[...slug].vue`)
- Standalone pages → Page content: queries (evidence: `app/pages/[...slug].vue`)
- Sidebar → Site settings: fetches (evidence: `app/components/SiteSidebar.vue`)
- Sidebar → Social links: fetches (evidence: `app/components/SiteSidebar.vue`)
- Sidebar → Theme state: uses (evidence: `app/components/SiteSidebar.vue`)
- Theme state → Browser local storage: persists theme (evidence: `app/composables/useTheme.ts`)
- Theme state → Theme styles: sets theme attribute (evidence: `app/composables/useTheme.ts`)
- Site settings → Typed collections: queries site (evidence: `app/composables/useSiteSettings.ts`)
- Experience data → Typed collections: queries experience (evidence: `app/composables/useExperience.ts`)
- Skills data → Typed collections: queries skills (evidence: `app/composables/useSkills.ts`)
- Project data → Typed collections: queries projects (evidence: `app/composables/useProjects.ts`)
- Social links → Typed collections: queries socials (evidence: `README.md`)
- Page content → Typed collections: queries pages (evidence: `app/pages/[...slug].vue`)
- Typed collections → Site profile files: defines source (evidence: `content.config.ts`)
- Typed collections → Career entries: defines source (evidence: `content.config.ts`)
- Typed collections → Skill groups: defines source (evidence: `content.config.ts`)
- Typed collections → Project entries: defines source (evidence: `content.config.ts`)
- Typed collections → Social entries: defines source (evidence: `content.config.ts`)
- Typed collections → Markdown pages: defines source (evidence: `content.config.ts`)
- Portfolio home → Visitor email app: opens mailto (evidence: `app/pages/index.vue`)
- Visitor → Resume download: downloads
