# paulinotech1/paulinotech architecture

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

- Interactive diagram: https://gitdiagram.com/paulinotech1/paulinotech
- Repository: https://github.com/paulinotech1/paulinotech

## Overview

Paulino Tech is a content-focused IT and security portfolio site. Visitors enter through the home page or shared navigation, then explore implementation write-ups and service topics; the newsletter route additionally fetches and presents live feed articles. The principal stages are portfolio discovery, infrastructure/security topic detail, and curated news. Route pages share a root layout and UI primitives, while metadata and site configuration support presentation. The source excerpts establish only some imports and links, so unsampled feature internals are represented by their exact route paths without inferred dependencies.

Main entry points: [`lib/metadata.ts`](https://github.com/paulinotech1/paulinotech/blob/main/lib/metadata.ts) (Page metadata), [`components/ui`](https://github.com/paulinotech1/paulinotech/tree/main/components/ui) (UI primitives), [`app/page.tsx`](https://github.com/paulinotech1/paulinotech/blob/main/app/page.tsx) (Home portfolio), [`lib/site-config.ts`](https://github.com/paulinotech1/paulinotech/blob/main/lib/site-config.ts) (Site configuration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Portfolio Discovery"]
  node_home["Home portfolio<br/>[page.tsx]"]
end

subgraph group_expertise["IT and Security Topics"]
  node_experience["IT experience<br/>[page.tsx]"]
  node_deployments["Deployment guides<br/>[page.tsx]"]
  node_homelab["Home lab<br/>[page.tsx]"]
  node_email["Email security<br/>[page.tsx]"]
  node_osint["OSINT<br/>[page.tsx]"]
  node_ai["AI tooling<br/>[page.tsx]"]
  node_consulting["Consulting<br/>[page.tsx]"]
  node_managed["Managed OS<br/>[page.tsx]"]
  node_vendor["Vendor tooling<br/>[page.tsx]"]
end

subgraph group_news["News and Feeds"]
  node_newsletter["Newsletter page<br/>[page.tsx]"]
  node_feeds["Feed retrieval<br/>[news-feeds.ts]"]
end

subgraph group_shared["Shared Presentation"]
  node_siteheader["Site navigation<br/>[site-header.tsx]"]
  node_sitefooter["Footer index<br/>[site-footer.tsx]"]
  node_layout["Root layout<br/>[layout.tsx]"]
  node_metadata["Page metadata<br/>[metadata.ts]"]
  node_config["Site configuration<br/>[site-config.ts]"]
  node_ui["UI primitives"]
  node_utils["Class utilities<br/>[utils.ts]"]
end

node_visitor(("Site visitor"))

node_visitor -->|"opens"| node_home
node_visitor -->|"navigates"| node_siteheader
node_home -->|"links to"| node_homelab
node_home -->|"links to"| node_email
node_siteheader -->|"reads links"| node_config
node_sitefooter -->|"reads links"| node_config
node_layout -->|"renders"| node_siteheader
node_layout -->|"renders"| node_sitefooter
node_layout -->|"uses"| node_config
node_newsletter -->|"fetches articles"| node_feeds
node_metadata -->|"reads identity"| node_config
node_experience -.->|"creates metadata"| node_metadata
node_deployments -.->|"creates metadata"| node_metadata
node_homelab -.->|"creates metadata"| node_metadata
node_email -.->|"creates metadata"| node_metadata
node_osint -.->|"creates metadata"| node_metadata
node_ai -.->|"creates metadata"| node_metadata
node_consulting -.->|"creates metadata"| node_metadata
node_managed -.->|"creates metadata"| node_metadata
node_vendor -.->|"creates metadata"| node_metadata
node_newsletter -.->|"creates metadata"| node_metadata
node_home -->|"uses components"| node_ui
node_experience -->|"uses components"| node_ui
node_deployments -->|"uses components"| node_ui
node_homelab -->|"uses components"| node_ui
node_email -->|"uses components"| node_ui
node_osint -->|"uses components"| node_ui
node_ai -->|"uses components"| node_ui
node_newsletter -->|"uses components"| node_ui
node_ui -->|"uses class helper"| node_utils

click node_home "https://github.com/paulinotech1/paulinotech/blob/main/app/page.tsx"
click node_siteheader "https://github.com/paulinotech1/paulinotech/blob/main/components/site-header.tsx"
click node_sitefooter "https://github.com/paulinotech1/paulinotech/blob/main/components/site-footer.tsx"
click node_experience "https://github.com/paulinotech1/paulinotech/blob/main/app/experience/page.tsx"
click node_deployments "https://github.com/paulinotech1/paulinotech/blob/main/app/deployments/page.tsx"
click node_homelab "https://github.com/paulinotech1/paulinotech/blob/main/app/homelab/page.tsx"
click node_email "https://github.com/paulinotech1/paulinotech/blob/main/app/email-security/page.tsx"
click node_osint "https://github.com/paulinotech1/paulinotech/blob/main/app/osint/page.tsx"
click node_ai "https://github.com/paulinotech1/paulinotech/blob/main/app/ai-tooling/page.tsx"
click node_consulting "https://github.com/paulinotech1/paulinotech/blob/main/app/consulting/page.tsx"
click node_managed "https://github.com/paulinotech1/paulinotech/blob/main/app/managed-os/page.tsx"
click node_vendor "https://github.com/paulinotech1/paulinotech/blob/main/app/vendor-tooling/page.tsx"
click node_newsletter "https://github.com/paulinotech1/paulinotech/blob/main/app/newsletter/page.tsx"
click node_feeds "https://github.com/paulinotech1/paulinotech/blob/main/lib/news-feeds.ts"
click node_layout "https://github.com/paulinotech1/paulinotech/blob/main/app/layout.tsx"
click node_metadata "https://github.com/paulinotech1/paulinotech/blob/main/lib/metadata.ts"
click node_config "https://github.com/paulinotech1/paulinotech/blob/main/lib/site-config.ts"
click node_ui "https://github.com/paulinotech1/paulinotech/tree/main/components/ui"
click node_utils "https://github.com/paulinotech1/paulinotech/blob/main/lib/utils.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_experience,node_deployments,node_homelab,node_email,node_osint,node_ai,node_consulting,node_managed,node_vendor toneAmber
class node_newsletter,node_feeds toneMint
class node_siteheader,node_sitefooter,node_layout,node_metadata,node_config,node_ui,node_utils toneRose
class node_visitor toneIndigo
```

## Components

### Portfolio Discovery

- [Home portfolio](https://github.com/paulinotech1/paulinotech/blob/main/app/page.tsx): `app/page.tsx`

### IT and Security Topics

- [IT experience](https://github.com/paulinotech1/paulinotech/blob/main/app/experience/page.tsx): `app/experience/page.tsx`
- [Deployment guides](https://github.com/paulinotech1/paulinotech/blob/main/app/deployments/page.tsx): `app/deployments/page.tsx`
- [Home lab](https://github.com/paulinotech1/paulinotech/blob/main/app/homelab/page.tsx): `app/homelab/page.tsx`
- [Email security](https://github.com/paulinotech1/paulinotech/blob/main/app/email-security/page.tsx): `app/email-security/page.tsx`
- [OSINT](https://github.com/paulinotech1/paulinotech/blob/main/app/osint/page.tsx): `app/osint/page.tsx`
- [AI tooling](https://github.com/paulinotech1/paulinotech/blob/main/app/ai-tooling/page.tsx): `app/ai-tooling/page.tsx`
- [Consulting](https://github.com/paulinotech1/paulinotech/blob/main/app/consulting/page.tsx): `app/consulting/page.tsx`
- [Managed OS](https://github.com/paulinotech1/paulinotech/blob/main/app/managed-os/page.tsx): `app/managed-os/page.tsx`
- [Vendor tooling](https://github.com/paulinotech1/paulinotech/blob/main/app/vendor-tooling/page.tsx): `app/vendor-tooling/page.tsx`

### News and Feeds

- [Newsletter page](https://github.com/paulinotech1/paulinotech/blob/main/app/newsletter/page.tsx): `app/newsletter/page.tsx`
- [Feed retrieval](https://github.com/paulinotech1/paulinotech/blob/main/lib/news-feeds.ts): `lib/news-feeds.ts`

### Shared Presentation

- [Site navigation](https://github.com/paulinotech1/paulinotech/blob/main/components/site-header.tsx): `components/site-header.tsx`
- [Footer index](https://github.com/paulinotech1/paulinotech/blob/main/components/site-footer.tsx): `components/site-footer.tsx`
- [Root layout](https://github.com/paulinotech1/paulinotech/blob/main/app/layout.tsx): `app/layout.tsx`
- [Page metadata](https://github.com/paulinotech1/paulinotech/blob/main/lib/metadata.ts): `lib/metadata.ts`
- [Site configuration](https://github.com/paulinotech1/paulinotech/blob/main/lib/site-config.ts): `lib/site-config.ts`
- [UI primitives](https://github.com/paulinotech1/paulinotech/tree/main/components/ui): `components/ui`
- [Class utilities](https://github.com/paulinotech1/paulinotech/blob/main/lib/utils.ts): `lib/utils.ts`

### Other components

- **Site visitor**

## Connections

- Site visitor → Home portfolio: opens (evidence: `app/page.tsx`)
- Site visitor → Site navigation: navigates
- Home portfolio → Home lab: links to (evidence: `app/page.tsx`)
- Home portfolio → Email security: links to (evidence: `app/page.tsx`)
- Site navigation → Site configuration: reads links (evidence: `components/site-header.tsx`)
- Footer index → Site configuration: reads links (evidence: `components/site-footer.tsx`)
- Root layout → Site navigation: renders (evidence: `app/layout.tsx`)
- Root layout → Footer index: renders (evidence: `app/layout.tsx`)
- Root layout → Site configuration: uses (evidence: `app/layout.tsx`)
- Newsletter page → Feed retrieval: fetches articles (evidence: `app/newsletter/page.tsx`)
- Page metadata → Site configuration: reads identity (evidence: `lib/metadata.ts`)
- IT experience → Page metadata: creates metadata (evidence: `app/experience/page.tsx`)
- Deployment guides → Page metadata: creates metadata (evidence: `app/deployments/page.tsx`)
- Home lab → Page metadata: creates metadata (evidence: `app/homelab/page.tsx`)
- Email security → Page metadata: creates metadata (evidence: `app/email-security/page.tsx`)
- OSINT → Page metadata: creates metadata (evidence: `app/osint/page.tsx`)
- AI tooling → Page metadata: creates metadata (evidence: `app/ai-tooling/page.tsx`)
- Consulting → Page metadata: creates metadata (evidence: `app/consulting/page.tsx`)
- Managed OS → Page metadata: creates metadata (evidence: `app/managed-os/page.tsx`)
- Vendor tooling → Page metadata: creates metadata (evidence: `app/vendor-tooling/page.tsx`)
- Newsletter page → Page metadata: creates metadata (evidence: `app/newsletter/page.tsx`)
- Home portfolio → UI primitives: uses components (evidence: `app/page.tsx`)
- IT experience → UI primitives: uses components (evidence: `app/experience/page.tsx`)
- Deployment guides → UI primitives: uses components (evidence: `app/deployments/page.tsx`)
- Home lab → UI primitives: uses components (evidence: `app/homelab/page.tsx`)
- Email security → UI primitives: uses components (evidence: `app/email-security/page.tsx`)
- OSINT → UI primitives: uses components (evidence: `app/osint/page.tsx`)
- AI tooling → UI primitives: uses components (evidence: `app/ai-tooling/page.tsx`)
- Newsletter page → UI primitives: uses components (evidence: `app/newsletter/page.tsx`)
- UI primitives → Class utilities: uses class helper (evidence: `components/ui/button.tsx`)
