How vijaypvk/cloudpulse_pages works
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: server.js Backend API · sidebar.jsx Navigation · buildAndServe.js Build and upload · page.jsx Repository selection
Components 19
Dashboard
- Home dashboard
src/app/pages/home/page.jsx - Navigation
src/app/components/sidebar.jsx - Project dashboard
src/app/components/DashboardHome.jsx - Deployment status
src/app/pages/deployment/deployment.jsx - Terminal display
src/app/components/terminal.jsx
Project Setup
- Connection choices
src/app/pages/gitconnect/page.jsx - Repository selection
src/app/pages/gitconnect2/page.jsx - Build configuration
src/app/pages/buildfromgit/page.jsx
Build Backend
- Webhook listener
backend/webhook/github.js - Backend API
backend/server.js - Build and upload
backend/buildandserve/buildAndServe.js - MinIO client
backend/utils/minioClient.js
Hosting
- MinIO object store
- Hosted file route
backend/server.js - NGINX routing
- Cloudflare Tunnel
Other components
- Project user
- GitHub
- Site visitor
Connections 26
- Project user → Home dashboard: opens dashboard
src/app/pages/home/page.jsx - Home dashboard → Navigation: renders
src/app/pages/home/page.jsx - Connection choices → Navigation: renders
src/app/pages/gitconnect/page.jsx - Repository selection → Navigation: renders
src/app/pages/gitconnect2/page.jsx - Build configuration → Navigation: renders
src/app/pages/buildfromgit/page.jsx - Connection choices → Repository selection: routes to
src/app/pages/gitconnect/page.jsx - Project user → Connection choices: chooses setup
- Repository selection → GitHub: selects repository
README.md - Project user → Build configuration: configures project
- GitHub → Webhook listener: sends push event
README.md - Webhook listener → Build and upload: queues build
README.md - Project user → Backend API: triggers build
README.md - Backend API → Build and upload: mounts build route
backend/server.js - Build and upload → GitHub: clones repository
README.md - Build and upload → MinIO client: uploads files
backend/buildandserve/buildAndServe.js - MinIO client → MinIO object store: stores objects
- Backend API → MinIO object store: reads hosted files
README.md - Site visitor → NGINX routing: requests subdomain
README.md - NGINX routing → Cloudflare Tunnel: routes securely
README.md - Cloudflare Tunnel → Backend API: forwards request
README.md - Backend API → Hosted file route: serves project
backend/server.js - Hosted file route → MinIO object store: streams object
backend/server.js - Project user → Project dashboard: views projects
README.md - Project user → Deployment status: views deployment
README.md - Deployment status → Navigation: renders
src/app/pages/deployment/deployment.jsx - Project dashboard → Terminal display: shows logs