# vijaypvk/cloudpulse_pages architecture

> Architecture diagram of the GitHub repository vijaypvk/cloudpulse_pages, 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/vijaypvk/cloudpulse_pages
- Repository: https://github.com/vijaypvk/cloudpulse_pages

## Overview

Cloudpulse is a Git-integrated static-site hosting platform with a Next.js dashboard and a Node/Express backend. The intended workflow is to connect a repository, configure a project, receive a GitHub push event or trigger a build, build or pass through static files, upload output to MinIO, and serve the hosted site. The dashboard also presents deployment status and logs. The README documents proxy, preview, and security capabilities, but the sampled tree does not show their implementation; those relationships are documented rather than verified in source.

Main entry points: [`backend/server.js`](https://github.com/vijaypvk/cloudpulse_pages/blob/main/backend/server.js) (Backend API), [`src/app/components/sidebar.jsx`](https://github.com/vijaypvk/cloudpulse_pages/blob/main/src/app/components/sidebar.jsx) (Navigation), [`backend/buildandserve/buildAndServe.js`](https://github.com/vijaypvk/cloudpulse_pages/blob/main/backend/buildandserve/buildAndServe.js) (Build and upload), [`src/app/pages/gitconnect2/page.jsx`](https://github.com/vijaypvk/cloudpulse_pages/blob/main/src/app/pages/gitconnect2/page.jsx) (Repository selection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_dashboard["Dashboard"]
  node_home["Home dashboard<br/>[page.jsx]"]
  node_sidebar["Navigation<br/>[sidebar.jsx]"]
  node_projectdash["Project dashboard<br/>[DashboardHome.jsx]"]
  node_deploymentui["Deployment status<br/>[deployment.jsx]"]
  node_terminal["Terminal display<br/>[terminal.jsx]"]
end

subgraph group_setup["Project Setup"]
  node_connect["Connection choices<br/>[page.jsx]"]
  node_repositories["Repository selection<br/>[page.jsx]"]
  node_buildconfig["Build configuration<br/>[page.jsx]"]
end

subgraph group_backend["Build Backend"]
  node_webhook["Webhook listener<br/>[github.js]"]
  node_api["Backend API<br/>[server.js]"]
  node_builder["Build and upload<br/>[buildAndServe.js]"]
  node_minio_client["MinIO client<br/>[minioClient.js]"]
end

subgraph group_hosting["Hosting"]
  node_minio[("MinIO object store")]
  node_hosted["Hosted file route<br/>[server.js]"]
  node_proxy["NGINX routing"]
  node_cloudflare["Cloudflare Tunnel"]
end

node_user(("Project user"))
node_github(("GitHub"))
node_visitor(("Site visitor"))

node_user -->|"opens dashboard"| node_home
node_home -->|"renders"| node_sidebar
node_connect -->|"renders"| node_sidebar
node_repositories -->|"renders"| node_sidebar
node_buildconfig -->|"renders"| node_sidebar
node_connect -->|"routes to"| node_repositories
node_user -.->|"chooses setup"| node_connect
node_repositories -.->|"selects repository"| node_github
node_user -.->|"configures project"| node_buildconfig
node_github -.->|"sends push event"| node_webhook
node_webhook -.->|"queues build"| node_builder
node_user -.->|"triggers build"| node_api
node_api -->|"mounts build route"| node_builder
node_builder -.->|"clones repository"| node_github
node_builder -->|"uploads files"| node_minio_client
node_minio_client -.->|"stores objects"| node_minio
node_api -.->|"reads hosted files"| node_minio
node_visitor -.->|"requests subdomain"| node_proxy
node_proxy -.->|"routes securely"| node_cloudflare
node_cloudflare -.->|"forwards request"| node_api
node_api -->|"serves project"| node_hosted
node_hosted -->|"streams object"| node_minio
node_user -.->|"views projects"| node_projectdash
node_user -.->|"views deployment"| node_deploymentui
node_deploymentui -->|"renders"| node_sidebar
node_projectdash -.->|"shows logs"| node_terminal

click node_home "https://github.com/vijaypvk/cloudpulse_pages/blob/main/src/app/pages/home/page.jsx"
click node_sidebar "https://github.com/vijaypvk/cloudpulse_pages/blob/main/src/app/components/sidebar.jsx"
click node_projectdash "https://github.com/vijaypvk/cloudpulse_pages/blob/main/src/app/components/DashboardHome.jsx"
click node_deploymentui "https://github.com/vijaypvk/cloudpulse_pages/blob/main/src/app/pages/deployment/deployment.jsx"
click node_terminal "https://github.com/vijaypvk/cloudpulse_pages/blob/main/src/app/components/terminal.jsx"
click node_connect "https://github.com/vijaypvk/cloudpulse_pages/blob/main/src/app/pages/gitconnect/page.jsx"
click node_repositories "https://github.com/vijaypvk/cloudpulse_pages/blob/main/src/app/pages/gitconnect2/page.jsx"
click node_buildconfig "https://github.com/vijaypvk/cloudpulse_pages/blob/main/src/app/pages/buildfromgit/page.jsx"
click node_webhook "https://github.com/vijaypvk/cloudpulse_pages/blob/main/backend/webhook/github.js"
click node_api "https://github.com/vijaypvk/cloudpulse_pages/blob/main/backend/server.js"
click node_builder "https://github.com/vijaypvk/cloudpulse_pages/blob/main/backend/buildandserve/buildAndServe.js"
click node_minio_client "https://github.com/vijaypvk/cloudpulse_pages/blob/main/backend/utils/minioClient.js"
click node_hosted "https://github.com/vijaypvk/cloudpulse_pages/blob/main/backend/server.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_home,node_sidebar,node_projectdash,node_deploymentui,node_terminal,node_user toneBlue
class node_connect,node_repositories,node_buildconfig toneAmber
class node_webhook,node_api,node_builder,node_minio_client toneMint
class node_minio,node_hosted,node_proxy,node_cloudflare toneRose
class node_github,node_visitor toneIndigo
```

## Components

### Dashboard

- [Home dashboard](https://github.com/vijaypvk/cloudpulse_pages/blob/main/src/app/pages/home/page.jsx): `src/app/pages/home/page.jsx`
- [Navigation](https://github.com/vijaypvk/cloudpulse_pages/blob/main/src/app/components/sidebar.jsx): `src/app/components/sidebar.jsx`
- [Project dashboard](https://github.com/vijaypvk/cloudpulse_pages/blob/main/src/app/components/DashboardHome.jsx): `src/app/components/DashboardHome.jsx`
- [Deployment status](https://github.com/vijaypvk/cloudpulse_pages/blob/main/src/app/pages/deployment/deployment.jsx): `src/app/pages/deployment/deployment.jsx`
- [Terminal display](https://github.com/vijaypvk/cloudpulse_pages/blob/main/src/app/components/terminal.jsx): `src/app/components/terminal.jsx`

### Project Setup

- [Connection choices](https://github.com/vijaypvk/cloudpulse_pages/blob/main/src/app/pages/gitconnect/page.jsx): `src/app/pages/gitconnect/page.jsx`
- [Repository selection](https://github.com/vijaypvk/cloudpulse_pages/blob/main/src/app/pages/gitconnect2/page.jsx): `src/app/pages/gitconnect2/page.jsx`
- [Build configuration](https://github.com/vijaypvk/cloudpulse_pages/blob/main/src/app/pages/buildfromgit/page.jsx): `src/app/pages/buildfromgit/page.jsx`

### Build Backend

- [Webhook listener](https://github.com/vijaypvk/cloudpulse_pages/blob/main/backend/webhook/github.js): `backend/webhook/github.js`
- [Backend API](https://github.com/vijaypvk/cloudpulse_pages/blob/main/backend/server.js): `backend/server.js`
- [Build and upload](https://github.com/vijaypvk/cloudpulse_pages/blob/main/backend/buildandserve/buildAndServe.js): `backend/buildandserve/buildAndServe.js`
- [MinIO client](https://github.com/vijaypvk/cloudpulse_pages/blob/main/backend/utils/minioClient.js): `backend/utils/minioClient.js`

### Hosting

- **MinIO object store**
- [Hosted file route](https://github.com/vijaypvk/cloudpulse_pages/blob/main/backend/server.js): `backend/server.js`
- **NGINX routing**
- **Cloudflare Tunnel**

### Other components

- **Project user**
- **GitHub**
- **Site visitor**

## Connections

- Project user → Home dashboard: opens dashboard (evidence: `src/app/pages/home/page.jsx`)
- Home dashboard → Navigation: renders (evidence: `src/app/pages/home/page.jsx`)
- Connection choices → Navigation: renders (evidence: `src/app/pages/gitconnect/page.jsx`)
- Repository selection → Navigation: renders (evidence: `src/app/pages/gitconnect2/page.jsx`)
- Build configuration → Navigation: renders (evidence: `src/app/pages/buildfromgit/page.jsx`)
- Connection choices → Repository selection: routes to (evidence: `src/app/pages/gitconnect/page.jsx`)
- Project user → Connection choices: chooses setup
- Repository selection → GitHub: selects repository (evidence: `README.md`)
- Project user → Build configuration: configures project
- GitHub → Webhook listener: sends push event (evidence: `README.md`)
- Webhook listener → Build and upload: queues build (evidence: `README.md`)
- Project user → Backend API: triggers build (evidence: `README.md`)
- Backend API → Build and upload: mounts build route (evidence: `backend/server.js`)
- Build and upload → GitHub: clones repository (evidence: `README.md`)
- Build and upload → MinIO client: uploads files (evidence: `backend/buildandserve/buildAndServe.js`)
- MinIO client → MinIO object store: stores objects
- Backend API → MinIO object store: reads hosted files (evidence: `README.md`)
- Site visitor → NGINX routing: requests subdomain (evidence: `README.md`)
- NGINX routing → Cloudflare Tunnel: routes securely (evidence: `README.md`)
- Cloudflare Tunnel → Backend API: forwards request (evidence: `README.md`)
- Backend API → Hosted file route: serves project (evidence: `backend/server.js`)
- Hosted file route → MinIO object store: streams object (evidence: `backend/server.js`)
- Project user → Project dashboard: views projects (evidence: `README.md`)
- Project user → Deployment status: views deployment (evidence: `README.md`)
- Deployment status → Navigation: renders (evidence: `src/app/pages/deployment/deployment.jsx`)
- Project dashboard → Terminal display: shows logs
