# notharshhaa/github-repo-status-tracker architecture

> Architecture diagram of the GitHub repository notharshhaa/github-repo-status-tracker, 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/notharshhaa/github-repo-status-tracker
- Repository: https://github.com/notharshhaa/github-repo-status-tracker

## Overview

This is a Next.js dashboard for browsing a curated set of DevOps and cloud GitHub repositories, their metrics, and related skills. A visitor opens the page, which reads the repository data, computes summary statistics, and supports searching, filtering, and sorting before rendering repository cards. The README also describes automatically refreshed GitHub status data; the refresh implementation is not traced here because the updater scripts were not excerpted. The graph focuses on the inspected UI and data flow.

Main entry points: [`src/app/page.tsx`](https://github.com/notharshhaa/github-repo-status-tracker/blob/master/src/app/page.tsx) (Dashboard page), [`src/components/header.tsx`](https://github.com/notharshhaa/github-repo-status-tracker/blob/master/src/components/header.tsx) (Navigation header), [`src/components/project-card.tsx`](https://github.com/notharshhaa/github-repo-status-tracker/blob/master/src/components/project-card.tsx) (Repository cards), [`src/data/repos-data.tsx`](https://github.com/notharshhaa/github-repo-status-tracker/blob/master/src/data/repos-data.tsx) (Dashboard content)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Dashboard experience"]
  node_page["Dashboard page<br/>[page.tsx]"]
  node_header["Navigation header<br/>[header.tsx]"]
  node_footer["Page footer<br/>[footer.tsx]"]
end

subgraph group_presentation["Repository presentation"]
  node_toolbar["Search and filters<br/>[repo-toolbar.tsx]"]
  node_cards["Repository cards<br/>[project-card.tsx]"]
  node_stats["Summary metrics<br/>[repo-stats.tsx]"]
  node_frames["Content framing<br/>[frame.tsx]"]
  node_badges["Skill badges<br/>[badge.tsx]"]
  node_button["Button controls<br/>[button.tsx]"]
  node_tooltip["Tooltip support<br/>[tooltip.tsx]"]
  node_links["Social links<br/>[button-link.tsx]"]
  node_icon["Social icons<br/>[github-icon.tsx]"]
end

subgraph group_content["Content and metrics"]
  node_data["Dashboard content<br/>[repos-data.tsx]"]
  node_projects["Repository records<br/>[projects-data.ts]"]
  node_constants["Data export<br/>[index.ts]"]
end

subgraph group_logic["Dashboard logic"]
  node_project_utils["Project calculations<br/>[project-utils.ts]"]
  node_class_utils["Class utilities<br/>[utils.ts]"]
end

node_visitor(("Visitor"))

node_visitor -->|"opens dashboard"| node_page
node_page -->|"reads data"| node_constants
node_constants -->|"exports dataset"| node_data
node_data -->|"includes records"| node_projects
node_data -->|"uses icon"| node_icon
node_page -->|"filters and counts"| node_project_utils
node_header -->|"counts projects"| node_project_utils
node_page -->|"renders"| node_header
node_page -->|"renders"| node_footer
node_page -->|"renders controls"| node_toolbar
node_page -->|"renders results"| node_cards
node_page -->|"renders metrics"| node_stats
node_page -->|"frames sections"| node_frames
node_page -->|"renders skills"| node_badges
node_page -->|"renders controls"| node_button
node_page -->|"provides tooltips"| node_tooltip
node_header -->|"renders links"| node_links
node_cards -->|"renders tags"| node_badges
node_cards -->|"merges classes"| node_class_utils
node_toolbar -->|"uses project helpers"| node_project_utils
node_header -->|"renders links"| node_links

click node_page "https://github.com/notharshhaa/github-repo-status-tracker/blob/master/src/app/page.tsx"
click node_header "https://github.com/notharshhaa/github-repo-status-tracker/blob/master/src/components/header.tsx"
click node_footer "https://github.com/notharshhaa/github-repo-status-tracker/blob/master/src/components/footer.tsx"
click node_toolbar "https://github.com/notharshhaa/github-repo-status-tracker/blob/master/src/components/repo-toolbar.tsx"
click node_cards "https://github.com/notharshhaa/github-repo-status-tracker/blob/master/src/components/project-card.tsx"
click node_stats "https://github.com/notharshhaa/github-repo-status-tracker/blob/master/src/components/repo-stats.tsx"
click node_frames "https://github.com/notharshhaa/github-repo-status-tracker/blob/master/src/components/frame.tsx"
click node_badges "https://github.com/notharshhaa/github-repo-status-tracker/blob/master/src/components/ui/badge.tsx"
click node_button "https://github.com/notharshhaa/github-repo-status-tracker/blob/master/src/components/ui/button.tsx"
click node_tooltip "https://github.com/notharshhaa/github-repo-status-tracker/blob/master/src/components/ui/tooltip.tsx"
click node_links "https://github.com/notharshhaa/github-repo-status-tracker/blob/master/src/components/button-link.tsx"
click node_icon "https://github.com/notharshhaa/github-repo-status-tracker/blob/master/src/components/icons/github-icon.tsx"
click node_data "https://github.com/notharshhaa/github-repo-status-tracker/blob/master/src/data/repos-data.tsx"
click node_projects "https://github.com/notharshhaa/github-repo-status-tracker/blob/master/src/data/projects-data.ts"
click node_project_utils "https://github.com/notharshhaa/github-repo-status-tracker/blob/master/src/lib/project-utils.ts"
click node_class_utils "https://github.com/notharshhaa/github-repo-status-tracker/blob/master/src/lib/utils.ts"
click node_constants "https://github.com/notharshhaa/github-repo-status-tracker/blob/master/src/constants/index.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_page,node_header,node_footer toneBlue
class node_toolbar,node_cards,node_stats,node_frames,node_badges,node_button,node_tooltip,node_links,node_icon toneAmber
class node_data,node_projects,node_constants toneMint
class node_project_utils,node_class_utils toneRose
class node_visitor toneIndigo
```

## Components

### Dashboard experience

- [Dashboard page](https://github.com/notharshhaa/github-repo-status-tracker/blob/master/src/app/page.tsx): `src/app/page.tsx`
- [Navigation header](https://github.com/notharshhaa/github-repo-status-tracker/blob/master/src/components/header.tsx): `src/components/header.tsx`
- [Page footer](https://github.com/notharshhaa/github-repo-status-tracker/blob/master/src/components/footer.tsx): `src/components/footer.tsx`

### Repository presentation

- [Search and filters](https://github.com/notharshhaa/github-repo-status-tracker/blob/master/src/components/repo-toolbar.tsx): `src/components/repo-toolbar.tsx`
- [Repository cards](https://github.com/notharshhaa/github-repo-status-tracker/blob/master/src/components/project-card.tsx): `src/components/project-card.tsx`
- [Summary metrics](https://github.com/notharshhaa/github-repo-status-tracker/blob/master/src/components/repo-stats.tsx): `src/components/repo-stats.tsx`
- [Content framing](https://github.com/notharshhaa/github-repo-status-tracker/blob/master/src/components/frame.tsx): `src/components/frame.tsx`
- [Skill badges](https://github.com/notharshhaa/github-repo-status-tracker/blob/master/src/components/ui/badge.tsx): `src/components/ui/badge.tsx`
- [Button controls](https://github.com/notharshhaa/github-repo-status-tracker/blob/master/src/components/ui/button.tsx): `src/components/ui/button.tsx`
- [Tooltip support](https://github.com/notharshhaa/github-repo-status-tracker/blob/master/src/components/ui/tooltip.tsx): `src/components/ui/tooltip.tsx`
- [Social links](https://github.com/notharshhaa/github-repo-status-tracker/blob/master/src/components/button-link.tsx): `src/components/button-link.tsx`
- [Social icons](https://github.com/notharshhaa/github-repo-status-tracker/blob/master/src/components/icons/github-icon.tsx): `src/components/icons/github-icon.tsx`

### Content and metrics

- [Dashboard content](https://github.com/notharshhaa/github-repo-status-tracker/blob/master/src/data/repos-data.tsx): `src/data/repos-data.tsx`
- [Repository records](https://github.com/notharshhaa/github-repo-status-tracker/blob/master/src/data/projects-data.ts): `src/data/projects-data.ts`
- [Data export](https://github.com/notharshhaa/github-repo-status-tracker/blob/master/src/constants/index.ts): `src/constants/index.ts`

### Dashboard logic

- [Project calculations](https://github.com/notharshhaa/github-repo-status-tracker/blob/master/src/lib/project-utils.ts): `src/lib/project-utils.ts`
- [Class utilities](https://github.com/notharshhaa/github-repo-status-tracker/blob/master/src/lib/utils.ts): `src/lib/utils.ts`

### Other components

- **Visitor**

## Connections

- Visitor → Dashboard page: opens dashboard (evidence: `src/app/page.tsx`)
- Dashboard page → Data export: reads data (evidence: `src/app/page.tsx`)
- Data export → Dashboard content: exports dataset (evidence: `src/constants/index.ts`)
- Dashboard content → Repository records: includes records (evidence: `src/data/repos-data.tsx`)
- Dashboard content → Social icons: uses icon (evidence: `src/data/repos-data.tsx`)
- Dashboard page → Project calculations: filters and counts (evidence: `src/app/page.tsx`)
- Navigation header → Project calculations: counts projects (evidence: `src/components/header.tsx`)
- Dashboard page → Navigation header: renders (evidence: `src/app/page.tsx`)
- Dashboard page → Page footer: renders (evidence: `src/app/page.tsx`)
- Dashboard page → Search and filters: renders controls (evidence: `src/app/page.tsx`)
- Dashboard page → Repository cards: renders results (evidence: `src/app/page.tsx`)
- Dashboard page → Summary metrics: renders metrics (evidence: `src/app/page.tsx`)
- Dashboard page → Content framing: frames sections (evidence: `src/app/page.tsx`)
- Dashboard page → Skill badges: renders skills (evidence: `src/app/page.tsx`)
- Dashboard page → Button controls: renders controls (evidence: `src/app/page.tsx`)
- Dashboard page → Tooltip support: provides tooltips (evidence: `src/app/page.tsx`)
- Navigation header → Social links: renders links (evidence: `src/components/header.tsx`)
- Repository cards → Skill badges: renders tags (evidence: `src/components/project-card.tsx`)
- Repository cards → Class utilities: merges classes (evidence: `src/components/project-card.tsx`)
- Search and filters → Project calculations: uses project helpers (evidence: `src/components/repo-toolbar.tsx`)
- Navigation header → Social links: renders links (evidence: `src/components/header.tsx`)
