# givanyo/portfolio architecture

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

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

## Overview

This is an Angular personal-portfolio site. A visitor enters the page, browses the introduction, technology stack and projects, and can open contact or expanded-stack modals; project and contact buttons expose external destinations. The graph preserves the documented-in-source portfolio sections and animation behavior. The supplied excerpts and source index support the shown component relationships, but templates and several component implementations were not inspected, so their internal rendering details are omitted.

Main entry points: [`src/app/app.ts`](https://github.com/givanyo/portfolio/blob/main/src/app/app.ts) (Application shell), [`src/app/shared/button/button.service.ts`](https://github.com/givanyo/portfolio/blob/main/src/app/shared/button/button.service.ts) (Button actions), [`src/app/header/header.ts`](https://github.com/givanyo/portfolio/blob/main/src/app/header/header.ts) (Header navigation), [`src/app/stack/stack.ts`](https://github.com/givanyo/portfolio/blob/main/src/app/stack/stack.ts) (Technology stack)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_portfolio["Portfolio sections"]
  node_app["Application shell<br/>[app.ts]"]
  node_header["Header navigation<br/>[header.ts]"]
  node_about["About section<br/>[about.ts]"]
  node_stack["Technology stack<br/>[stack.ts]"]
  node_projects["Project gallery<br/>[projects.ts]"]
  node_projectcard["Project card<br/>[project-card.ts]"]
  node_projectdata["Project data<br/>[project.model.ts]"]
  node_footer["Footer<br/>[footer.ts]"]
  node_contact["Contact modal<br/>[contact-full.ts]"]
  node_stackmodal["Expanded stack<br/>[stack-full.ts]"]
end

subgraph group_interaction["Interaction services"]
  node_modalservice["Modal state<br/>[modal.service.ts]"]
  node_buttonservice["Button actions<br/>[button.service.ts]"]
  node_gsap["Film-roll animation<br/>[gsap.service.ts]"]
  node_lenis["Smooth scrolling<br/>[lenis.service.ts]"]
end

subgraph group_presentation["Reusable presentation"]
  node_button["Button component<br/>[button.ts]"]
  node_buttondata["Button data<br/>[button.model.ts]"]
  node_card["Stack card<br/>[card.ts]"]
  node_carddata["Card data<br/>[card.model.ts]"]
  node_stackcard["Technology card<br/>[stack-card.ts]"]
  node_stackcarddata["Technology card data"]
end

node_visitor(("Visitor"))

node_visitor -->|"opens portfolio"| node_app
node_app -->|"imports section"| node_header
node_app -->|"imports section"| node_about
node_app -->|"imports section"| node_stack
node_app -->|"imports section"| node_projects
node_app -->|"imports section"| node_footer
node_app -->|"imports modal"| node_contact
node_app -->|"imports modal"| node_stackmodal
node_app -->|"reads modal state"| node_modalservice
node_header -->|"runs animation"| node_gsap
node_header -->|"reads modal state"| node_modalservice
node_header -->|"uses buttons"| node_buttonservice
node_about -->|"uses buttons"| node_buttonservice
node_contact -->|"uses links"| node_buttonservice
node_footer -->|"uses buttons"| node_buttonservice
node_projects -->|"imports cards"| node_projectcard
node_projectcard -->|"accepts project data"| node_projectdata
node_projectcard -->|"selects destination"| node_buttonservice
node_stack -->|"uses cards"| node_card
node_stack -->|"provides card data"| node_carddata
node_stack -->|"uses stack action"| node_buttonservice
node_stackmodal -->|"uses technology cards"| node_stackcard
node_stackmodal -->|"uses card data"| node_stackcarddata
node_buttonservice -->|"toggles modal state"| node_modalservice
node_modalservice -->|"stops or starts"| node_lenis
node_button -->|"accepts button data"| node_buttondata

click node_app "https://github.com/givanyo/portfolio/blob/main/src/app/app.ts"
click node_header "https://github.com/givanyo/portfolio/blob/main/src/app/header/header.ts"
click node_about "https://github.com/givanyo/portfolio/blob/main/src/app/about/about.ts"
click node_stack "https://github.com/givanyo/portfolio/blob/main/src/app/stack/stack.ts"
click node_projects "https://github.com/givanyo/portfolio/blob/main/src/app/projects/projects.ts"
click node_projectcard "https://github.com/givanyo/portfolio/blob/main/src/app/projects/project-card/project-card.ts"
click node_projectdata "https://github.com/givanyo/portfolio/blob/main/src/app/projects/project-card/project.model.ts"
click node_footer "https://github.com/givanyo/portfolio/blob/main/src/app/footer/footer.ts"
click node_contact "https://github.com/givanyo/portfolio/blob/main/src/app/contact-full/contact-full.ts"
click node_stackmodal "https://github.com/givanyo/portfolio/blob/main/src/app/stack/stack-full/stack-full.ts"
click node_modalservice "https://github.com/givanyo/portfolio/blob/main/src/app/modal.service.ts"
click node_buttonservice "https://github.com/givanyo/portfolio/blob/main/src/app/shared/button/button.service.ts"
click node_button "https://github.com/givanyo/portfolio/blob/main/src/app/shared/button/button.ts"
click node_buttondata "https://github.com/givanyo/portfolio/blob/main/src/app/shared/button/button.model.ts"
click node_card "https://github.com/givanyo/portfolio/blob/main/src/app/shared/card/card.ts"
click node_carddata "https://github.com/givanyo/portfolio/blob/main/src/app/shared/card/card.model.ts"
click node_stackcard "https://github.com/givanyo/portfolio/blob/main/src/app/shared/stack-card/stack-card.ts"
click node_stackcarddata "https://github.com/givanyo/portfolio/blob/main/src/app/shared/stack-card/stack-card.model.ts"
click node_gsap "https://github.com/givanyo/portfolio/blob/main/src/app/animation/gsap.service.ts"
click node_lenis "https://github.com/givanyo/portfolio/blob/main/src/app/animation/lenis.service.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_app,node_header,node_about,node_stack,node_projects,node_projectcard,node_projectdata,node_footer,node_contact,node_stackmodal toneBlue
class node_modalservice,node_buttonservice,node_gsap,node_lenis toneAmber
class node_button,node_buttondata,node_card,node_carddata,node_stackcard,node_stackcarddata toneMint
class node_visitor toneIndigo
```

## Components

### Portfolio sections

- [Application shell](https://github.com/givanyo/portfolio/blob/main/src/app/app.ts): `src/app/app.ts`
- [Header navigation](https://github.com/givanyo/portfolio/blob/main/src/app/header/header.ts): `src/app/header/header.ts`
- [About section](https://github.com/givanyo/portfolio/blob/main/src/app/about/about.ts): `src/app/about/about.ts`
- [Technology stack](https://github.com/givanyo/portfolio/blob/main/src/app/stack/stack.ts): `src/app/stack/stack.ts`
- [Project gallery](https://github.com/givanyo/portfolio/blob/main/src/app/projects/projects.ts): `src/app/projects/projects.ts`
- [Project card](https://github.com/givanyo/portfolio/blob/main/src/app/projects/project-card/project-card.ts): `src/app/projects/project-card/project-card.ts`
- [Project data](https://github.com/givanyo/portfolio/blob/main/src/app/projects/project-card/project.model.ts): `src/app/projects/project-card/project.model.ts`
- [Footer](https://github.com/givanyo/portfolio/blob/main/src/app/footer/footer.ts): `src/app/footer/footer.ts`
- [Contact modal](https://github.com/givanyo/portfolio/blob/main/src/app/contact-full/contact-full.ts): `src/app/contact-full/contact-full.ts`
- [Expanded stack](https://github.com/givanyo/portfolio/blob/main/src/app/stack/stack-full/stack-full.ts): `src/app/stack/stack-full/stack-full.ts`

### Interaction services

- [Modal state](https://github.com/givanyo/portfolio/blob/main/src/app/modal.service.ts): `src/app/modal.service.ts`
- [Button actions](https://github.com/givanyo/portfolio/blob/main/src/app/shared/button/button.service.ts): `src/app/shared/button/button.service.ts`
- [Film-roll animation](https://github.com/givanyo/portfolio/blob/main/src/app/animation/gsap.service.ts): `src/app/animation/gsap.service.ts`
- [Smooth scrolling](https://github.com/givanyo/portfolio/blob/main/src/app/animation/lenis.service.ts): `src/app/animation/lenis.service.ts`

### Reusable presentation

- [Button component](https://github.com/givanyo/portfolio/blob/main/src/app/shared/button/button.ts): `src/app/shared/button/button.ts`
- [Button data](https://github.com/givanyo/portfolio/blob/main/src/app/shared/button/button.model.ts): `src/app/shared/button/button.model.ts`
- [Stack card](https://github.com/givanyo/portfolio/blob/main/src/app/shared/card/card.ts): `src/app/shared/card/card.ts`
- [Card data](https://github.com/givanyo/portfolio/blob/main/src/app/shared/card/card.model.ts): `src/app/shared/card/card.model.ts`
- [Technology card](https://github.com/givanyo/portfolio/blob/main/src/app/shared/stack-card/stack-card.ts): `src/app/shared/stack-card/stack-card.ts`
- [Technology card data](https://github.com/givanyo/portfolio/blob/main/src/app/shared/stack-card/stack-card.model.ts): `src/app/shared/stack-card/stack-card.model.ts`

### Other components

- **Visitor**

## Connections

- Visitor → Application shell: opens portfolio
- Application shell → Header navigation: imports section (evidence: `src/app/app.ts`)
- Application shell → About section: imports section (evidence: `src/app/app.ts`)
- Application shell → Technology stack: imports section (evidence: `src/app/app.ts`)
- Application shell → Project gallery: imports section (evidence: `src/app/app.ts`)
- Application shell → Footer: imports section (evidence: `src/app/app.ts`)
- Application shell → Contact modal: imports modal (evidence: `src/app/app.ts`)
- Application shell → Expanded stack: imports modal (evidence: `src/app/app.ts`)
- Application shell → Modal state: reads modal state (evidence: `src/app/app.ts`)
- Header navigation → Film-roll animation: runs animation (evidence: `src/app/header/header.ts`)
- Header navigation → Modal state: reads modal state (evidence: `src/app/header/header.ts`)
- Header navigation → Button actions: uses buttons (evidence: `src/app/header/header.ts`)
- About section → Button actions: uses buttons (evidence: `src/app/about/about.ts`)
- Contact modal → Button actions: uses links (evidence: `src/app/contact-full/contact-full.ts`)
- Footer → Button actions: uses buttons (evidence: `src/app/footer/footer.ts`)
- Project gallery → Project card: imports cards (evidence: `src/app/projects/projects.ts`)
- Project card → Project data: accepts project data (evidence: `src/app/projects/project-card/project-card.ts`)
- Project card → Button actions: selects destination (evidence: `src/app/projects/project-card/project-card.ts`)
- Technology stack → Stack card: uses cards (evidence: `src/app/stack/stack.ts`)
- Technology stack → Card data: provides card data (evidence: `src/app/stack/stack.ts`)
- Technology stack → Button actions: uses stack action (evidence: `src/app/stack/stack.ts`)
- Expanded stack → Technology card: uses technology cards (evidence: `src/app/stack/stack-full/stack-full.ts`)
- Expanded stack → Technology card data: uses card data (evidence: `src/app/stack/stack-full/stack-full.ts`)
- Button actions → Modal state: toggles modal state (evidence: `src/app/shared/button/button.service.ts`)
- Modal state → Smooth scrolling: stops or starts (evidence: `src/app/modal.service.ts`)
- Button component → Button data: accepts button data (evidence: `src/app/shared/button/button.ts`)
