# vaibhavsirana8474/git-activity-pulse architecture

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

- Interactive diagram: https://gitdiagram.com/vaibhavsirana8474/git-activity-pulse
- Repository: https://github.com/vaibhavsirana8474/git-activity-pulse

## Overview

This is a browser-based GitHub commit analytics dashboard. A user enters a repository, the app fetches recent commits, computes activity, contributor, and sentiment metrics, then presents charts and a commit table; users can filter results and export them as CSV. The implementation is concentrated in app.js, so several distinct responsibilities share that path. The README documents the dashboard’s capabilities, while the excerpts show only parts of the implementation; edges are limited to relationships visible in those excerpts or documented in the README.

Main entry points: [`app.js`](https://github.com/vaibhavsirana8474/git-activity-pulse/blob/main/app.js) (GitHub Ingestion), [`index.html`](https://github.com/vaibhavsirana8474/git-activity-pulse/blob/main/index.html) (Repository Entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_analysis["Commit Analysis"]
  node_sentiment["Message Sentiment<br/>[app.js]"]
  node_activity["Activity Metrics<br/>[app.js]"]
  node_contributor["Contributor Metrics<br/>[app.js]"]
end

subgraph group_presentation["Dashboard Output"]
  node_dashboard["Dashboard Metrics<br/>[app.js]"]
  node_charts["Activity and Sentiment Charts<br/>[app.js]"]
  node_commit_table["Commit Sentiment Table<br/>[app.js]"]
  node_csv_export["CSV Export<br/>[app.js]"]
end

subgraph group_interaction["User Controls"]
  node_repo_form["Repository Entry<br/>[index.html]"]
  node_ingestion["GitHub Ingestion<br/>[app.js]"]
  node_filters["Author Date Filters<br/>[app.js]"]
end

node_user(("User"))
node_github["GitHub REST API"]
node_chartjs["Chart.js"]

node_user -->|"enters repository"| node_repo_form
node_repo_form -->|"starts analysis"| node_ingestion
node_ingestion -->|"fetches commits"| node_github
node_ingestion -->|"processes commits"| node_activity
node_ingestion -->|"scores messages"| node_sentiment
node_ingestion -->|"counts authors"| node_contributor
node_filters -->|"reprocesses filtered commits"| node_activity
node_filters -->|"reprocesses filtered commits"| node_sentiment
node_activity -->|"updates metrics"| node_dashboard
node_contributor -->|"updates top contributor"| node_dashboard
node_sentiment -->|"updates average score"| node_dashboard
node_activity -->|"supplies hourly counts"| node_charts
node_sentiment -->|"supplies trend scores"| node_charts
node_charts -->|"creates charts"| node_chartjs
node_sentiment -->|"renders scores"| node_commit_table
node_user -->|"sets filters"| node_filters
node_user -->|"requests export"| node_csv_export

click node_repo_form "https://github.com/vaibhavsirana8474/git-activity-pulse/blob/main/index.html"
click node_ingestion "https://github.com/vaibhavsirana8474/git-activity-pulse/blob/main/app.js"
click node_filters "https://github.com/vaibhavsirana8474/git-activity-pulse/blob/main/app.js"
click node_sentiment "https://github.com/vaibhavsirana8474/git-activity-pulse/blob/main/app.js"
click node_activity "https://github.com/vaibhavsirana8474/git-activity-pulse/blob/main/app.js"
click node_contributor "https://github.com/vaibhavsirana8474/git-activity-pulse/blob/main/app.js"
click node_dashboard "https://github.com/vaibhavsirana8474/git-activity-pulse/blob/main/app.js"
click node_charts "https://github.com/vaibhavsirana8474/git-activity-pulse/blob/main/app.js"
click node_commit_table "https://github.com/vaibhavsirana8474/git-activity-pulse/blob/main/app.js"
click node_csv_export "https://github.com/vaibhavsirana8474/git-activity-pulse/blob/main/app.js"

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_sentiment,node_activity,node_contributor,node_user toneBlue
class node_dashboard,node_charts,node_commit_table,node_csv_export toneAmber
class node_repo_form,node_ingestion,node_filters,node_github toneMint
class node_chartjs toneIndigo
```

## Components

### Commit Analysis

- [Message Sentiment](https://github.com/vaibhavsirana8474/git-activity-pulse/blob/main/app.js): `app.js`
- [Activity Metrics](https://github.com/vaibhavsirana8474/git-activity-pulse/blob/main/app.js): `app.js`
- [Contributor Metrics](https://github.com/vaibhavsirana8474/git-activity-pulse/blob/main/app.js): `app.js`

### Dashboard Output

- [Dashboard Metrics](https://github.com/vaibhavsirana8474/git-activity-pulse/blob/main/app.js): `app.js`
- [Activity and Sentiment Charts](https://github.com/vaibhavsirana8474/git-activity-pulse/blob/main/app.js): `app.js`
- [Commit Sentiment Table](https://github.com/vaibhavsirana8474/git-activity-pulse/blob/main/app.js): `app.js`
- [CSV Export](https://github.com/vaibhavsirana8474/git-activity-pulse/blob/main/app.js): `app.js`

### User Controls

- [Repository Entry](https://github.com/vaibhavsirana8474/git-activity-pulse/blob/main/index.html): `index.html`
- [GitHub Ingestion](https://github.com/vaibhavsirana8474/git-activity-pulse/blob/main/app.js): `app.js`
- [Author Date Filters](https://github.com/vaibhavsirana8474/git-activity-pulse/blob/main/app.js): `app.js`

### Other components

- **User**
- **GitHub REST API**
- **Chart.js**

## Connections

- User → Repository Entry: enters repository (evidence: `README.md`)
- Repository Entry → GitHub Ingestion: starts analysis (evidence: `app.js`)
- GitHub Ingestion → GitHub REST API: fetches commits (evidence: `app.js`)
- GitHub Ingestion → Activity Metrics: processes commits (evidence: `app.js`)
- GitHub Ingestion → Message Sentiment: scores messages (evidence: `app.js`)
- GitHub Ingestion → Contributor Metrics: counts authors (evidence: `app.js`)
- Author Date Filters → Activity Metrics: reprocesses filtered commits (evidence: `app.js`)
- Author Date Filters → Message Sentiment: reprocesses filtered commits (evidence: `app.js`)
- Activity Metrics → Dashboard Metrics: updates metrics (evidence: `app.js`)
- Contributor Metrics → Dashboard Metrics: updates top contributor (evidence: `app.js`)
- Message Sentiment → Dashboard Metrics: updates average score (evidence: `app.js`)
- Activity Metrics → Activity and Sentiment Charts: supplies hourly counts (evidence: `app.js`)
- Message Sentiment → Activity and Sentiment Charts: supplies trend scores (evidence: `app.js`)
- Activity and Sentiment Charts → Chart.js: creates charts (evidence: `app.js`)
- Message Sentiment → Commit Sentiment Table: renders scores (evidence: `app.js`)
- User → Author Date Filters: sets filters (evidence: `app.js`)
- User → CSV Export: requests export (evidence: `app.js`)
