# istmx/final_portfolio_repo architecture

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

- Interactive diagram: https://gitdiagram.com/istmx/final_portfolio_repo
- Repository: https://github.com/istmx/final_portfolio_repo

## Overview

This is a Next.js developer portfolio template. Visitors browse the portfolio homepage, follow project or social links, read the blog index and individual posts, or enter the optional Cat Home experience. The main internal layers are reusable presentation components and the Cat Home simulation/rendering engine. The graph preserves documented SEO and interaction capabilities; relationships for unsampled components are included only where the README or source index supports them.

Main entry points: [`app/page.tsx`](https://github.com/istmx/final_portfolio_repo/blob/main/app/page.tsx) (Portfolio homepage), [`lib/cat/engine.ts`](https://github.com/istmx/final_portfolio_repo/blob/main/lib/cat/engine.ts) (Behavior engine), [`app/blogs/page.tsx`](https://github.com/istmx/final_portfolio_repo/blob/main/app/blogs/page.tsx) (Blog index), [`components/Navbar.tsx`](https://github.com/istmx/final_portfolio_repo/blob/main/components/Navbar.tsx) (Navigation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_portfolio["Portfolio pages"]
  node_home["Portfolio homepage<br/>[page.tsx]"]
end

subgraph group_blog["Blog publishing"]
  node_blogindex["Blog index<br/>[page.tsx]"]
  node_posts["Post content<br/>[blogData.ts]"]
  node_postcard["Article cards<br/>[BlogPostCard.tsx]"]
  node_article["Article page<br/>[page.tsx]"]
end

subgraph group_cat["Cat Home"]
  node_catpage["Cat Home page<br/>[page.tsx]"]
  node_catgame["Cat simulation<br/>[CatHomeGame.tsx]"]
  node_engine["Behavior engine<br/>[engine.ts]"]
  node_room["Room and artwork<br/>[room.ts]"]
  node_sprite["Animated sprites<br/>[sprite.ts]"]
  node_interactions["Cat interactions<br/>[interactions.ts]"]
  node_font["Pixel text<br/>[pixel-font.ts]"]
  node_browserstate[("Browser persistence")]
end

subgraph group_shared["Shared presentation"]
  node_hero["Profile introduction<br/>[IntroHero.tsx]"]
  node_social["Social links<br/>[SocialLinks.tsx]"]
  node_projects["Project showcase"]
  node_projectdata["Project content<br/>[projectData.ts]"]
  node_tech["Technology stack"]
  node_contributions["GitHub contributions"]
  node_blogssection["Homepage writing<br/>[BlogsSection.tsx]"]
  node_container["Page layout<br/>[Contanier.tsx]"]
  node_navbar["Navigation<br/>[Navbar.tsx]"]
  node_theme["Theme controls<br/>[ThemeToggle.tsx]"]
  node_pixelcat["Floating pixel cat<br/>[PixelCat.tsx]"]
  node_catsprite["Cat sprite view<br/>[CatSprite.tsx]"]
end

subgraph group_discoverability["SEO discoverability"]
  node_layout["Root layout<br/>[layout.tsx]"]
  node_robots["Crawler rules<br/>[robots.ts]"]
  node_sitemap["Sitemap<br/>[sitemap.ts]"]
  node_site["Site configuration<br/>[site.ts]"]
end

node_visitor(("Visitor"))

node_visitor -->|"opens"| node_home
node_visitor -.->|"browses"| node_blogindex
node_visitor -.->|"explores"| node_catpage
node_home -->|"renders"| node_container
node_home -->|"renders"| node_navbar
node_home -->|"renders"| node_hero
node_home -->|"renders"| node_social
node_home -->|"renders"| node_projects
node_home -->|"renders"| node_tech
node_home -->|"renders"| node_contributions
node_home -->|"renders"| node_blogssection
node_home -->|"renders"| node_pixelcat
node_navbar -->|"renders"| node_theme
node_projects -->|"reads"| node_projectdata
node_blogssection -.->|"reads"| node_posts
node_blogindex -->|"reads"| node_posts
node_blogindex -->|"renders"| node_postcard
node_blogindex -->|"renders"| node_navbar
node_blogindex -->|"renders"| node_container
node_postcard -->|"reads"| node_posts
node_visitor -.->|"opens"| node_article
node_article -->|"reads"| node_posts
node_article -->|"renders"| node_navbar
node_catpage -->|"renders"| node_catgame
node_catgame -->|"drives"| node_engine
node_catgame -->|"uses"| node_room
node_engine -->|"calls"| node_room
node_engine -->|"draws"| node_sprite
node_engine -->|"dispatches"| node_interactions
node_engine -->|"draws"| node_font
node_interactions -.->|"uses"| node_room
node_engine -->|"reads and writes"| node_browserstate
node_pixelcat -->|"renders"| node_catsprite
node_catsprite -->|"uses"| node_sprite
node_layout -->|"configures"| node_site
node_robots -->|"reads"| node_site
node_sitemap -.->|"uses"| node_site

click node_home "https://github.com/istmx/final_portfolio_repo/blob/main/app/page.tsx"
click node_hero "https://github.com/istmx/final_portfolio_repo/blob/main/components/IntroHero.tsx"
click node_social "https://github.com/istmx/final_portfolio_repo/blob/main/components/SocialLinks.tsx"
click node_projects "https://github.com/istmx/final_portfolio_repo/blob/main/components/ProjectsSection.tsx"
click node_projectdata "https://github.com/istmx/final_portfolio_repo/blob/main/components/projectData.ts"
click node_tech "https://github.com/istmx/final_portfolio_repo/blob/main/components/TechStackSection.tsx"
click node_contributions "https://github.com/istmx/final_portfolio_repo/blob/main/components/GitHubContributions.tsx"
click node_blogssection "https://github.com/istmx/final_portfolio_repo/blob/main/components/BlogsSection.tsx"
click node_container "https://github.com/istmx/final_portfolio_repo/blob/main/components/Contanier.tsx"
click node_navbar "https://github.com/istmx/final_portfolio_repo/blob/main/components/Navbar.tsx"
click node_theme "https://github.com/istmx/final_portfolio_repo/blob/main/components/ThemeToggle.tsx"
click node_pixelcat "https://github.com/istmx/final_portfolio_repo/blob/main/components/PixelCat.tsx"
click node_catsprite "https://github.com/istmx/final_portfolio_repo/blob/main/components/CatSprite.tsx"
click node_blogindex "https://github.com/istmx/final_portfolio_repo/blob/main/app/blogs/page.tsx"
click node_posts "https://github.com/istmx/final_portfolio_repo/blob/main/app/blogs/blogData.ts"
click node_postcard "https://github.com/istmx/final_portfolio_repo/blob/main/components/BlogPostCard.tsx"
click node_article "https://github.com/istmx/final_portfolio_repo/blob/main/app/blogs/%5Bslug%5D/page.tsx"
click node_catpage "https://github.com/istmx/final_portfolio_repo/blob/main/app/cat-home/page.tsx"
click node_catgame "https://github.com/istmx/final_portfolio_repo/blob/main/app/cat-home/CatHomeGame.tsx"
click node_engine "https://github.com/istmx/final_portfolio_repo/blob/main/lib/cat/engine.ts"
click node_room "https://github.com/istmx/final_portfolio_repo/blob/main/lib/cat/room.ts"
click node_sprite "https://github.com/istmx/final_portfolio_repo/blob/main/lib/cat/sprite.ts"
click node_interactions "https://github.com/istmx/final_portfolio_repo/blob/main/lib/cat/interactions.ts"
click node_font "https://github.com/istmx/final_portfolio_repo/blob/main/lib/cat/pixel-font.ts"
click node_layout "https://github.com/istmx/final_portfolio_repo/blob/main/app/layout.tsx"
click node_robots "https://github.com/istmx/final_portfolio_repo/blob/main/app/robots.ts"
click node_sitemap "https://github.com/istmx/final_portfolio_repo/blob/main/app/sitemap.ts"
click node_site "https://github.com/istmx/final_portfolio_repo/blob/main/lib/site.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_home toneBlue
class node_blogindex,node_posts,node_postcard,node_article toneAmber
class node_catpage,node_catgame,node_engine,node_room,node_sprite,node_interactions,node_font,node_browserstate toneMint
class node_hero,node_social,node_projects,node_projectdata,node_tech,node_contributions,node_blogssection,node_container,node_navbar,node_theme,node_pixelcat,node_catsprite toneRose
class node_layout,node_robots,node_sitemap,node_site,node_visitor toneIndigo
```

## Components

### Portfolio pages

- [Portfolio homepage](https://github.com/istmx/final_portfolio_repo/blob/main/app/page.tsx): `app/page.tsx`

### Blog publishing

- [Blog index](https://github.com/istmx/final_portfolio_repo/blob/main/app/blogs/page.tsx): `app/blogs/page.tsx`
- [Post content](https://github.com/istmx/final_portfolio_repo/blob/main/app/blogs/blogData.ts): `app/blogs/blogData.ts`
- [Article cards](https://github.com/istmx/final_portfolio_repo/blob/main/components/BlogPostCard.tsx): `components/BlogPostCard.tsx`
- [Article page](https://github.com/istmx/final_portfolio_repo/blob/main/app/blogs/%5Bslug%5D/page.tsx): `app/blogs/[slug]/page.tsx`

### Cat Home

- [Cat Home page](https://github.com/istmx/final_portfolio_repo/blob/main/app/cat-home/page.tsx): `app/cat-home/page.tsx`
- [Cat simulation](https://github.com/istmx/final_portfolio_repo/blob/main/app/cat-home/CatHomeGame.tsx): `app/cat-home/CatHomeGame.tsx`
- [Behavior engine](https://github.com/istmx/final_portfolio_repo/blob/main/lib/cat/engine.ts): `lib/cat/engine.ts`
- [Room and artwork](https://github.com/istmx/final_portfolio_repo/blob/main/lib/cat/room.ts): `lib/cat/room.ts`
- [Animated sprites](https://github.com/istmx/final_portfolio_repo/blob/main/lib/cat/sprite.ts): `lib/cat/sprite.ts`
- [Cat interactions](https://github.com/istmx/final_portfolio_repo/blob/main/lib/cat/interactions.ts): `lib/cat/interactions.ts`
- [Pixel text](https://github.com/istmx/final_portfolio_repo/blob/main/lib/cat/pixel-font.ts): `lib/cat/pixel-font.ts`
- **Browser persistence**

### Shared presentation

- [Profile introduction](https://github.com/istmx/final_portfolio_repo/blob/main/components/IntroHero.tsx): `components/IntroHero.tsx`
- [Social links](https://github.com/istmx/final_portfolio_repo/blob/main/components/SocialLinks.tsx): `components/SocialLinks.tsx`
- [Project showcase](https://github.com/istmx/final_portfolio_repo/blob/main/components/ProjectsSection.tsx): `components/ProjectsSection.tsx`
- [Project content](https://github.com/istmx/final_portfolio_repo/blob/main/components/projectData.ts): `components/projectData.ts`
- [Technology stack](https://github.com/istmx/final_portfolio_repo/blob/main/components/TechStackSection.tsx): `components/TechStackSection.tsx`
- [GitHub contributions](https://github.com/istmx/final_portfolio_repo/blob/main/components/GitHubContributions.tsx): `components/GitHubContributions.tsx`
- [Homepage writing](https://github.com/istmx/final_portfolio_repo/blob/main/components/BlogsSection.tsx): `components/BlogsSection.tsx`
- [Page layout](https://github.com/istmx/final_portfolio_repo/blob/main/components/Contanier.tsx): `components/Contanier.tsx`
- [Navigation](https://github.com/istmx/final_portfolio_repo/blob/main/components/Navbar.tsx): `components/Navbar.tsx`
- [Theme controls](https://github.com/istmx/final_portfolio_repo/blob/main/components/ThemeToggle.tsx): `components/ThemeToggle.tsx`
- [Floating pixel cat](https://github.com/istmx/final_portfolio_repo/blob/main/components/PixelCat.tsx): `components/PixelCat.tsx`
- [Cat sprite view](https://github.com/istmx/final_portfolio_repo/blob/main/components/CatSprite.tsx): `components/CatSprite.tsx`

### SEO discoverability

- [Root layout](https://github.com/istmx/final_portfolio_repo/blob/main/app/layout.tsx): `app/layout.tsx`
- [Crawler rules](https://github.com/istmx/final_portfolio_repo/blob/main/app/robots.ts): `app/robots.ts`
- [Sitemap](https://github.com/istmx/final_portfolio_repo/blob/main/app/sitemap.ts): `app/sitemap.ts`
- [Site configuration](https://github.com/istmx/final_portfolio_repo/blob/main/lib/site.ts): `lib/site.ts`

### Other components

- **Visitor**

## Connections

- Visitor → Portfolio homepage: opens (evidence: `app/page.tsx`)
- Visitor → Blog index: browses (evidence: `README.md`)
- Visitor → Cat Home page: explores (evidence: `README.md`)
- Portfolio homepage → Page layout: renders (evidence: `app/page.tsx`)
- Portfolio homepage → Navigation: renders (evidence: `app/page.tsx`)
- Portfolio homepage → Profile introduction: renders (evidence: `app/page.tsx`)
- Portfolio homepage → Social links: renders (evidence: `app/page.tsx`)
- Portfolio homepage → Project showcase: renders (evidence: `app/page.tsx`)
- Portfolio homepage → Technology stack: renders (evidence: `app/page.tsx`)
- Portfolio homepage → GitHub contributions: renders (evidence: `app/page.tsx`)
- Portfolio homepage → Homepage writing: renders (evidence: `app/page.tsx`)
- Portfolio homepage → Floating pixel cat: renders (evidence: `app/page.tsx`)
- Navigation → Theme controls: renders (evidence: `components/Navbar.tsx`)
- Project showcase → Project content: reads (evidence: `components/ProjectsSection.tsx`)
- Homepage writing → Post content: reads (evidence: `README.md`)
- Blog index → Post content: reads (evidence: `app/blogs/page.tsx`)
- Blog index → Article cards: renders (evidence: `app/blogs/page.tsx`)
- Blog index → Navigation: renders (evidence: `app/blogs/page.tsx`)
- Blog index → Page layout: renders (evidence: `app/blogs/page.tsx`)
- Article cards → Post content: reads (evidence: `components/BlogPostCard.tsx`)
- Visitor → Article page: opens (evidence: `README.md`)
- Article page → Post content: reads (evidence: `app/blogs/[slug]/page.tsx`)
- Article page → Navigation: renders (evidence: `app/blogs/[slug]/page.tsx`)
- Cat Home page → Cat simulation: renders (evidence: `app/cat-home/page.tsx`)
- Cat simulation → Behavior engine: drives (evidence: `app/cat-home/CatHomeGame.tsx`)
- Cat simulation → Room and artwork: uses (evidence: `app/cat-home/CatHomeGame.tsx`)
- Behavior engine → Room and artwork: calls (evidence: `lib/cat/engine.ts`)
- Behavior engine → Animated sprites: draws (evidence: `lib/cat/engine.ts`)
- Behavior engine → Cat interactions: dispatches (evidence: `lib/cat/engine.ts`)
- Behavior engine → Pixel text: draws (evidence: `lib/cat/engine.ts`)
- Cat interactions → Room and artwork: uses (evidence: `lib/cat/interactions.ts`)
- Behavior engine → Browser persistence: reads and writes (evidence: `lib/cat/engine.ts`)
- Floating pixel cat → Cat sprite view: renders (evidence: `components/PixelCat.tsx`)
- Cat sprite view → Animated sprites: uses (evidence: `components/CatSprite.tsx`)
- Root layout → Site configuration: configures (evidence: `app/layout.tsx`)
- Crawler rules → Site configuration: reads (evidence: `app/robots.ts`)
- Sitemap → Site configuration: uses
