# pisethmao/launchly architecture

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

## Overview

Launchly is a web application for deploying projects, managing deployments, and administering users and projects. The main deployment paths accept a repository or ZIP upload, invoke a remote VM deployment, and—on the shown routes—record deployment state; users can also register and view deployments. The tree indicates additional billing and admin capabilities, though several implementations were not sampled. Edges reflect shown calls or imports; unsampled feature wiring is omitted or marked unverified.

Main entry points: [`src/app/api/deploy/route.ts`](https://github.com/pisethmao/launchly/blob/master/src/app/api/deploy/route.ts) (Repository deploy), [`src/lib/prisma.ts`](https://github.com/pisethmao/launchly/blob/master/src/lib/prisma.ts) (Prisma client), [`src/lib/auth.ts`](https://github.com/pisethmao/launchly/blob/master/src/lib/auth.ts) (Authentication), [`src/app/api/deploy-zip/route.ts`](https://github.com/pisethmao/launchly/blob/master/src/app/api/deploy-zip/route.ts) (ZIP deploy)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_navbar["Navigation<br/>[Navbar.tsx]"]
  node_navdata["Navigation data<br/>[navItemData.ts]"]
  node_navtypes["Navigation types<br/>[navItemType.ts]"]
  node_urlutil["URL utilities<br/>[urls.ts]"]
  node_deployui["Deployment pages<br/>[page.tsx]"]
  node_billingui["Billing page<br/>[page.tsx]"]
  node_marketing["Marketing pages<br/>[page.tsx]"]
end

subgraph group_deploy["Deployment"]
  node_repo_deploy["Repository deploy<br/>[route.ts]"]
  node_zip_deploy["ZIP deploy<br/>[route.ts]"]
  node_create_deployment["Create deployment<br/>[route.ts]"]
  node_deployment_list["List deployments<br/>[route.ts]"]
  node_redeploy["Redeploy<br/>[route.ts]"]
  node_sync_script["Script sync<br/>[route.ts]"]
end

subgraph group_identity["Identity and data"]
  node_auth["Authentication<br/>[auth.ts]"]
  node_registration["Registration<br/>[route.ts]"]
  node_db["Database client<br/>[db.ts]"]
  node_prisma["Prisma client<br/>[prisma.ts]"]
  node_deployment_store[("Deployment records<br/>[prisma.ts]")]
  node_billing_api["Billing APIs"]
end

subgraph group_admin["Administration"]
  node_admin_login["Admin login<br/>[route.ts]"]
  node_admin_auth["Admin verification<br/>[adminAuth.ts]"]
  node_admin_projects["Project administration<br/>[route.ts]"]
end

node_visitor(("Visitor"))
node_vm["Deployment VM"]
node_git_hosts["Git providers"]
node_cloudflare["Cloudflare DNS"]

node_navbar -->|"reads"| node_navdata
node_navbar -->|"uses"| node_urlutil
node_navdata -->|"uses types"| node_navtypes
node_visitor -.->|"submits"| node_deployui
node_visitor -.->|"visits"| node_billingui
node_visitor -.->|"visits"| node_marketing
node_deployui -.->|"requests"| node_repo_deploy
node_repo_deploy -->|"fetches"| node_sync_script
node_repo_deploy -->|"runs deploy"| node_vm
node_repo_deploy -.->|"clones repository"| node_git_hosts
node_repo_deploy -->|"gets session"| node_auth
node_repo_deploy -->|"saves deployment"| node_prisma
node_zip_deploy -->|"uploads and deploys"| node_vm
node_zip_deploy -->|"gets session"| node_auth
node_zip_deploy -->|"saves deployment"| node_prisma
node_create_deployment -->|"gets session"| node_auth
node_create_deployment -->|"creates record"| node_prisma
node_deployment_list -->|"gets session"| node_auth
node_deployment_list -->|"reads records"| node_prisma
node_redeploy -->|"reads deployment"| node_prisma
node_redeploy -->|"runs deploy"| node_vm
node_repo_deploy -->|"writes"| node_deployment_store
node_zip_deploy -->|"writes"| node_deployment_store
node_create_deployment -->|"writes"| node_deployment_store
node_deployment_list -->|"reads"| node_deployment_store
node_registration -->|"creates user"| node_db
node_auth -->|"checks credentials"| node_db
node_visitor -.->|"registers"| node_registration
node_billingui -.->|"uses"| node_billing_api
node_admin_login -->|"looks up admin"| node_prisma
node_admin_projects -->|"manages records"| node_prisma
node_admin_projects -->|"deletes DNS"| node_cloudflare
node_admin_projects -->|"deletes record"| node_deployment_store
node_admin_auth -.->|"verifies issued token"| node_admin_login

click node_navbar "https://github.com/pisethmao/launchly/blob/master/src/components/navbar/Navbar.tsx"
click node_navdata "https://github.com/pisethmao/launchly/blob/master/src/data/navItemData.ts"
click node_navtypes "https://github.com/pisethmao/launchly/blob/master/src/types/navItemType.ts"
click node_urlutil "https://github.com/pisethmao/launchly/blob/master/src/utils/urls.ts"
click node_deployui "https://github.com/pisethmao/launchly/blob/master/src/app/deploy/new/page.tsx"
click node_billingui "https://github.com/pisethmao/launchly/blob/master/src/app/billing/page.tsx"
click node_marketing "https://github.com/pisethmao/launchly/blob/master/src/app/page.tsx"
click node_repo_deploy "https://github.com/pisethmao/launchly/blob/master/src/app/api/deploy/route.ts"
click node_zip_deploy "https://github.com/pisethmao/launchly/blob/master/src/app/api/deploy-zip/route.ts"
click node_create_deployment "https://github.com/pisethmao/launchly/blob/master/src/app/api/deployments/create/route.ts"
click node_deployment_list "https://github.com/pisethmao/launchly/blob/master/src/app/api/deployments/list/route.ts"
click node_redeploy "https://github.com/pisethmao/launchly/blob/master/src/app/api/redeploy/route.ts"
click node_sync_script "https://github.com/pisethmao/launchly/blob/master/src/app/api/sync-script/route.ts"
click node_auth "https://github.com/pisethmao/launchly/blob/master/src/lib/auth.ts"
click node_registration "https://github.com/pisethmao/launchly/blob/master/src/app/api/register/route.ts"
click node_db "https://github.com/pisethmao/launchly/blob/master/src/lib/db.ts"
click node_prisma "https://github.com/pisethmao/launchly/blob/master/src/lib/prisma.ts"
click node_deployment_store "https://github.com/pisethmao/launchly/blob/master/src/lib/prisma.ts"
click node_billing_api "https://github.com/pisethmao/launchly/tree/master/src/app/api/billing"
click node_admin_login "https://github.com/pisethmao/launchly/blob/master/src/app/api/admin/login/route.ts"
click node_admin_auth "https://github.com/pisethmao/launchly/blob/master/src/lib/adminAuth.ts"
click node_admin_projects "https://github.com/pisethmao/launchly/blob/master/src/app/api/admin/projects/%5Bid%5D/route.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_navbar,node_navdata,node_navtypes,node_urlutil,node_deployui,node_billingui,node_marketing toneBlue
class node_repo_deploy,node_zip_deploy,node_create_deployment,node_deployment_list,node_redeploy,node_sync_script toneAmber
class node_auth,node_registration,node_db,node_prisma,node_deployment_store,node_billing_api toneMint
class node_admin_login,node_admin_auth,node_admin_projects toneRose
class node_visitor,node_vm,node_git_hosts,node_cloudflare toneIndigo
```

## Components

### Web experience

- [Navigation](https://github.com/pisethmao/launchly/blob/master/src/components/navbar/Navbar.tsx): `src/components/navbar/Navbar.tsx`
- [Navigation data](https://github.com/pisethmao/launchly/blob/master/src/data/navItemData.ts): `src/data/navItemData.ts`
- [Navigation types](https://github.com/pisethmao/launchly/blob/master/src/types/navItemType.ts): `src/types/navItemType.ts`
- [URL utilities](https://github.com/pisethmao/launchly/blob/master/src/utils/urls.ts): `src/utils/urls.ts`
- [Deployment pages](https://github.com/pisethmao/launchly/blob/master/src/app/deploy/new/page.tsx): `src/app/deploy/new/page.tsx`
- [Billing page](https://github.com/pisethmao/launchly/blob/master/src/app/billing/page.tsx): `src/app/billing/page.tsx`
- [Marketing pages](https://github.com/pisethmao/launchly/blob/master/src/app/page.tsx): `src/app/page.tsx`

### Deployment

- [Repository deploy](https://github.com/pisethmao/launchly/blob/master/src/app/api/deploy/route.ts): `src/app/api/deploy/route.ts`
- [ZIP deploy](https://github.com/pisethmao/launchly/blob/master/src/app/api/deploy-zip/route.ts): `src/app/api/deploy-zip/route.ts`
- [Create deployment](https://github.com/pisethmao/launchly/blob/master/src/app/api/deployments/create/route.ts): `src/app/api/deployments/create/route.ts`
- [List deployments](https://github.com/pisethmao/launchly/blob/master/src/app/api/deployments/list/route.ts): `src/app/api/deployments/list/route.ts`
- [Redeploy](https://github.com/pisethmao/launchly/blob/master/src/app/api/redeploy/route.ts): `src/app/api/redeploy/route.ts`
- [Script sync](https://github.com/pisethmao/launchly/blob/master/src/app/api/sync-script/route.ts): `src/app/api/sync-script/route.ts`

### Identity and data

- [Authentication](https://github.com/pisethmao/launchly/blob/master/src/lib/auth.ts): `src/lib/auth.ts`
- [Registration](https://github.com/pisethmao/launchly/blob/master/src/app/api/register/route.ts): `src/app/api/register/route.ts`
- [Database client](https://github.com/pisethmao/launchly/blob/master/src/lib/db.ts): `src/lib/db.ts`
- [Prisma client](https://github.com/pisethmao/launchly/blob/master/src/lib/prisma.ts): `src/lib/prisma.ts`
- [Deployment records](https://github.com/pisethmao/launchly/blob/master/src/lib/prisma.ts): `src/lib/prisma.ts`
- [Billing APIs](https://github.com/pisethmao/launchly/tree/master/src/app/api/billing): `src/app/api/billing`

### Administration

- [Admin login](https://github.com/pisethmao/launchly/blob/master/src/app/api/admin/login/route.ts): `src/app/api/admin/login/route.ts`
- [Admin verification](https://github.com/pisethmao/launchly/blob/master/src/lib/adminAuth.ts): `src/lib/adminAuth.ts`
- [Project administration](https://github.com/pisethmao/launchly/blob/master/src/app/api/admin/projects/%5Bid%5D/route.ts): `src/app/api/admin/projects/[id]/route.ts`

### Other components

- **Visitor**
- **Deployment VM**
- **Git providers**
- **Cloudflare DNS**

## Connections

- Navigation → Navigation data: reads (evidence: `src/components/navbar/Navbar.tsx`)
- Navigation → URL utilities: uses (evidence: `src/components/navbar/Navbar.tsx`)
- Navigation data → Navigation types: uses types (evidence: `src/data/navItemData.ts`)
- Visitor → Deployment pages: submits
- Visitor → Billing page: visits
- Visitor → Marketing pages: visits
- Deployment pages → Repository deploy: requests
- Repository deploy → Script sync: fetches (evidence: `src/app/api/deploy/route.ts`)
- Repository deploy → Deployment VM: runs deploy (evidence: `src/app/api/deploy/route.ts`)
- Repository deploy → Git providers: clones repository
- Repository deploy → Authentication: gets session (evidence: `src/app/api/deploy/route.ts`)
- Repository deploy → Prisma client: saves deployment (evidence: `src/app/api/deploy/route.ts`)
- ZIP deploy → Deployment VM: uploads and deploys (evidence: `src/app/api/deploy-zip/route.ts`)
- ZIP deploy → Authentication: gets session (evidence: `src/app/api/deploy-zip/route.ts`)
- ZIP deploy → Prisma client: saves deployment (evidence: `src/app/api/deploy-zip/route.ts`)
- Create deployment → Authentication: gets session (evidence: `src/app/api/deployments/create/route.ts`)
- Create deployment → Prisma client: creates record (evidence: `src/app/api/deployments/create/route.ts`)
- List deployments → Authentication: gets session (evidence: `src/app/api/deployments/list/route.ts`)
- List deployments → Prisma client: reads records (evidence: `src/app/api/deployments/list/route.ts`)
- Redeploy → Prisma client: reads deployment (evidence: `src/app/api/redeploy/route.ts`)
- Redeploy → Deployment VM: runs deploy (evidence: `src/app/api/redeploy/route.ts`)
- Repository deploy → Deployment records: writes (evidence: `src/app/api/deploy/route.ts`)
- ZIP deploy → Deployment records: writes (evidence: `src/app/api/deploy-zip/route.ts`)
- Create deployment → Deployment records: writes (evidence: `src/app/api/deployments/create/route.ts`)
- List deployments → Deployment records: reads (evidence: `src/app/api/deployments/list/route.ts`)
- Registration → Database client: creates user (evidence: `src/app/api/register/route.ts`)
- Authentication → Database client: checks credentials (evidence: `src/lib/auth.ts`)
- Visitor → Registration: registers
- Billing page → Billing APIs: uses
- Admin login → Prisma client: looks up admin (evidence: `src/app/api/admin/login/route.ts`)
- Project administration → Prisma client: manages records (evidence: `src/app/api/admin/projects/[id]/route.ts`)
- Project administration → Cloudflare DNS: deletes DNS (evidence: `src/app/api/admin/projects/[id]/route.ts`)
- Project administration → Deployment records: deletes record (evidence: `src/app/api/admin/projects/[id]/route.ts`)
- Admin verification → Admin login: verifies issued token
