# shauryakant/launchpad-app architecture

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

- Interactive diagram: https://gitdiagram.com/shauryakant/launchpad-app
- Repository: https://github.com/shauryakant/launchpad-app

## Overview

Launchpad accepts a GitHub repository, stages its source, builds it asynchronously, and serves the resulting site under a project-specific URL. The frontend submits deployments and polls status; the uploader handles cloning and staging, the worker builds and publishes artifacts, and the request handler serves them. The README documents the queue, storage, and routing contracts; sampled source confirms key orchestration calls. Some integrations and the request handler’s internals are documented but not sampled.

Main entry points: [`uploader-service/src/index.ts`](https://github.com/shauryakant/launchpad-app/blob/main/uploader-service/src/index.ts) (Uploader API), [`Deployer-service/src/index.ts`](https://github.com/shauryakant/launchpad-app/blob/main/Deployer-service/src/index.ts) (Build Worker), [`frontend-deployer/src/App.jsx`](https://github.com/shauryakant/launchpad-app/blob/main/frontend-deployer/src/App.jsx) (Deployment Form), [`request handle service/src/index.ts`](https://github.com/shauryakant/launchpad-app/blob/main/request%20handle%20service/src/index.ts) (Request Router)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Deployment UI"]
  node_frontend_app["Deployment Form<br/>[App.jsx]"]
end

subgraph group_ingest["Source Ingestion"]
  node_uploader_api["Uploader API<br/>[index.ts]"]
  node_project_id["Project ID Generator<br/>[utils.ts]"]
  node_repo_clone["Repository Clone<br/>[index.ts]"]
  node_source_files["Source File Enumerator<br/>[getAllFile.ts]"]
  node_raw_upload["Source Uploader<br/>[uploadFile.ts]"]
end

subgraph group_build["Build Worker"]
  node_build_worker["Build Worker<br/>[index.ts]"]
  node_source_download["Source Downloader<br/>[downloadFolder.ts]"]
  node_project_build["Project Build<br/>[buildProject.ts]"]
  node_artifact_files["Artifact Enumerator"]
  node_artifact_upload["Artifact Uploader<br/>[uploadArtifact.ts]"]
end

subgraph group_delivery["Site Delivery"]
  node_request_handler["Request Router<br/>[index.ts]"]
end

node_user(("User"))
node_object_storage[("Object Storage")]
node_build_queue["Build Queue"]
node_status_store[("Deployment Status")]
node_browser(("Site Visitor"))

node_user -->|"submits URL"| node_frontend_app
node_frontend_app -->|"requests deployment"| node_uploader_api
node_frontend_app -->|"polls status"| node_uploader_api
node_uploader_api -->|"generates ID"| node_project_id
node_uploader_api -->|"clones repository"| node_repo_clone
node_repo_clone -->|"enumerates files"| node_source_files
node_uploader_api -->|"uploads source"| node_raw_upload
node_raw_upload -->|"writes source"| node_object_storage
node_uploader_api -->|"enqueues ID"| node_build_queue
node_uploader_api -->|"sets status"| node_status_store
node_build_worker -->|"dequeues jobs"| node_build_queue
node_build_worker -->|"updates status"| node_status_store
node_build_worker -->|"downloads source"| node_source_download
node_source_download -->|"reads source"| node_object_storage
node_build_worker -->|"runs build"| node_project_build
node_build_worker -->|"enumerates output"| node_artifact_files
node_build_worker -->|"uploads artifacts"| node_artifact_upload
node_artifact_upload -->|"writes artifacts"| node_object_storage
node_browser -->|"requests site"| node_request_handler
node_request_handler -->|"fetches built assets"| node_object_storage
node_request_handler -->|"serves site"| node_browser

click node_frontend_app "https://github.com/shauryakant/launchpad-app/blob/main/frontend-deployer/src/App.jsx"
click node_uploader_api "https://github.com/shauryakant/launchpad-app/blob/main/uploader-service/src/index.ts"
click node_project_id "https://github.com/shauryakant/launchpad-app/blob/main/uploader-service/src/utils.ts"
click node_repo_clone "https://github.com/shauryakant/launchpad-app/blob/main/uploader-service/src/index.ts"
click node_source_files "https://github.com/shauryakant/launchpad-app/blob/main/uploader-service/src/getAllFile.ts"
click node_raw_upload "https://github.com/shauryakant/launchpad-app/blob/main/uploader-service/src/uploadFile.ts"
click node_build_worker "https://github.com/shauryakant/launchpad-app/blob/main/Deployer-service/src/index.ts"
click node_source_download "https://github.com/shauryakant/launchpad-app/blob/main/Deployer-service/src/downloadFolder.ts"
click node_project_build "https://github.com/shauryakant/launchpad-app/blob/main/Deployer-service/src/buildProject.ts"
click node_artifact_files "https://github.com/shauryakant/launchpad-app/blob/main/Deployer-service/src/getAllBuiltArtifact.ts"
click node_artifact_upload "https://github.com/shauryakant/launchpad-app/blob/main/Deployer-service/src/uploadArtifact.ts"
click node_request_handler "https://github.com/shauryakant/launchpad-app/blob/main/request%20handle%20service/src/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_frontend_app,node_user toneBlue
class node_uploader_api,node_project_id,node_repo_clone,node_source_files,node_raw_upload,node_object_storage,node_status_store toneAmber
class node_build_worker,node_source_download,node_project_build,node_artifact_files,node_artifact_upload toneMint
class node_request_handler,node_build_queue toneRose
class node_browser toneIndigo
```

## Components

### Deployment UI

- [Deployment Form](https://github.com/shauryakant/launchpad-app/blob/main/frontend-deployer/src/App.jsx): `frontend-deployer/src/App.jsx`

### Source Ingestion

- [Uploader API](https://github.com/shauryakant/launchpad-app/blob/main/uploader-service/src/index.ts): `uploader-service/src/index.ts`
- [Project ID Generator](https://github.com/shauryakant/launchpad-app/blob/main/uploader-service/src/utils.ts): `uploader-service/src/utils.ts`
- [Repository Clone](https://github.com/shauryakant/launchpad-app/blob/main/uploader-service/src/index.ts): `uploader-service/src/index.ts`
- [Source File Enumerator](https://github.com/shauryakant/launchpad-app/blob/main/uploader-service/src/getAllFile.ts): `uploader-service/src/getAllFile.ts`
- [Source Uploader](https://github.com/shauryakant/launchpad-app/blob/main/uploader-service/src/uploadFile.ts): `uploader-service/src/uploadFile.ts`

### Build Worker

- [Build Worker](https://github.com/shauryakant/launchpad-app/blob/main/Deployer-service/src/index.ts): `Deployer-service/src/index.ts`
- [Source Downloader](https://github.com/shauryakant/launchpad-app/blob/main/Deployer-service/src/downloadFolder.ts): `Deployer-service/src/downloadFolder.ts`
- [Project Build](https://github.com/shauryakant/launchpad-app/blob/main/Deployer-service/src/buildProject.ts): `Deployer-service/src/buildProject.ts`
- [Artifact Enumerator](https://github.com/shauryakant/launchpad-app/blob/main/Deployer-service/src/getAllBuiltArtifact.ts): `Deployer-service/src/getAllBuiltArtifact.ts`
- [Artifact Uploader](https://github.com/shauryakant/launchpad-app/blob/main/Deployer-service/src/uploadArtifact.ts): `Deployer-service/src/uploadArtifact.ts`

### Site Delivery

- [Request Router](https://github.com/shauryakant/launchpad-app/blob/main/request%20handle%20service/src/index.ts): `request handle service/src/index.ts`

### Other components

- **User**
- **Object Storage**
- **Build Queue**
- **Deployment Status**
- **Site Visitor**

## Connections

- User → Deployment Form: submits URL (evidence: `README.md`)
- Deployment Form → Uploader API: requests deployment (evidence: `frontend-deployer/src/App.jsx`)
- Deployment Form → Uploader API: polls status (evidence: `frontend-deployer/src/App.jsx`)
- Uploader API → Project ID Generator: generates ID (evidence: `uploader-service/src/index.ts`)
- Uploader API → Repository Clone: clones repository (evidence: `uploader-service/src/index.ts`)
- Repository Clone → Source File Enumerator: enumerates files (evidence: `uploader-service/src/index.ts`)
- Uploader API → Source Uploader: uploads source (evidence: `uploader-service/src/index.ts`)
- Source Uploader → Object Storage: writes source (evidence: `README.md`)
- Uploader API → Build Queue: enqueues ID (evidence: `uploader-service/src/index.ts`)
- Uploader API → Deployment Status: sets status (evidence: `uploader-service/src/index.ts`)
- Build Worker → Build Queue: dequeues jobs (evidence: `README.md`)
- Build Worker → Deployment Status: updates status (evidence: `Deployer-service/src/index.ts`)
- Build Worker → Source Downloader: downloads source (evidence: `Deployer-service/src/index.ts`)
- Source Downloader → Object Storage: reads source (evidence: `Deployer-service/src/downloadFolder.ts`)
- Build Worker → Project Build: runs build (evidence: `Deployer-service/src/index.ts`)
- Build Worker → Artifact Enumerator: enumerates output (evidence: `Deployer-service/src/index.ts`)
- Build Worker → Artifact Uploader: uploads artifacts (evidence: `Deployer-service/src/index.ts`)
- Artifact Uploader → Object Storage: writes artifacts (evidence: `README.md`)
- Site Visitor → Request Router: requests site (evidence: `README.md`)
- Request Router → Object Storage: fetches built assets (evidence: `README.md`)
- Request Router → Site Visitor: serves site (evidence: `README.md`)
