242 lines
6 KiB
Markdown
242 lines
6 KiB
Markdown
# Coolify AIO Cleanup Implementation Plan
|
|
|
|
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
|
|
|
|
**Goal:** Reduce this Hoppscotch fork to the packages and deployment files required for Coolify AIO.
|
|
|
|
**Architecture:** Keep the existing AIO Docker architecture and remove code outside that deployment path. The workspace remains a pnpm monorepo, but `pnpm-workspace.yaml`, root scripts, and compose services are narrowed to the retained packages.
|
|
|
|
**Tech Stack:** pnpm workspaces, Docker Compose, multi-stage Dockerfile, NestJS backend, Vue/Vite frontends, Prisma, Caddy.
|
|
|
|
---
|
|
|
|
### Task 1: Remove Non-AIO Packages
|
|
|
|
**Files:**
|
|
- Delete: `packages/hoppscotch-desktop`
|
|
- Delete: `packages/hoppscotch-agent`
|
|
- Delete: `packages/hoppscotch-cli`
|
|
- Delete: `packages/hoppscotch-relay`
|
|
|
|
- [ ] **Step 1: Delete package directories**
|
|
|
|
Run:
|
|
|
|
```bash
|
|
rm -rf packages/hoppscotch-desktop packages/hoppscotch-agent packages/hoppscotch-cli packages/hoppscotch-relay
|
|
```
|
|
|
|
Expected: directories are absent from `find packages -maxdepth 1 -mindepth 1 -type d`.
|
|
|
|
- [ ] **Step 2: Verify retained package list**
|
|
|
|
Run:
|
|
|
|
```bash
|
|
find packages -maxdepth 1 -mindepth 1 -type d -printf '%f\n' | sort
|
|
```
|
|
|
|
Expected output contains only:
|
|
|
|
```text
|
|
codemirror-lang-graphql
|
|
hoppscotch-backend
|
|
hoppscotch-common
|
|
hoppscotch-data
|
|
hoppscotch-js-sandbox
|
|
hoppscotch-kernel
|
|
hoppscotch-selfhost-web
|
|
hoppscotch-sh-admin
|
|
```
|
|
|
|
### Task 2: Narrow Workspace And Root Scripts
|
|
|
|
**Files:**
|
|
- Modify: `pnpm-workspace.yaml`
|
|
- Modify: `package.json`
|
|
|
|
- [ ] **Step 1: Replace workspace glob**
|
|
|
|
Set `pnpm-workspace.yaml` to:
|
|
|
|
```yaml
|
|
packages:
|
|
- 'packages/codemirror-lang-graphql'
|
|
- 'packages/hoppscotch-backend'
|
|
- 'packages/hoppscotch-common'
|
|
- 'packages/hoppscotch-data'
|
|
- 'packages/hoppscotch-js-sandbox'
|
|
- 'packages/hoppscotch-kernel'
|
|
- 'packages/hoppscotch-selfhost-web'
|
|
- 'packages/hoppscotch-sh-admin'
|
|
```
|
|
|
|
- [ ] **Step 2: Simplify root scripts**
|
|
|
|
Keep scripts that make sense for the retained AIO deployment:
|
|
|
|
```json
|
|
{
|
|
"dev": "pnpm -r do-dev",
|
|
"gen-gql": "cross-env GQL_SCHEMA_EMIT_LOCATION='../../../gql-gen/backend-schema.gql' pnpm -r generate-gql-sdl",
|
|
"generate": "pnpm -r do-build-prod",
|
|
"start": "http-server packages/hoppscotch-selfhost-web/dist -p 3000",
|
|
"lint": "pnpm -r do-lint",
|
|
"typecheck": "pnpm -r do-typecheck",
|
|
"lintfix": "pnpm -r do-lintfix",
|
|
"pre-commit": "pnpm -r do-lint && pnpm -r do-typecheck",
|
|
"test": "pnpm -r do-test"
|
|
}
|
|
```
|
|
|
|
Remove `generate-ui`, because it is not a Coolify deployment concern.
|
|
|
|
### Task 3: Simplify Docker Compose For Coolify AIO
|
|
|
|
**Files:**
|
|
- Modify: `docker-compose.yml`
|
|
- Delete: `docker-compose.deploy.yml`
|
|
|
|
- [ ] **Step 1: Replace compose file with AIO deployment**
|
|
|
|
Keep only `hoppscotch-db` and `hoppscotch-aio`. Preserve the AIO command:
|
|
|
|
```yaml
|
|
services:
|
|
hoppscotch-db:
|
|
image: postgres:15
|
|
user: postgres
|
|
environment:
|
|
POSTGRES_USER: postgres
|
|
POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-testpass}
|
|
POSTGRES_DB: ${POSTGRES_DB:-hoppscotch}
|
|
volumes:
|
|
- hoppscotch-db:/var/lib/postgresql/data
|
|
healthcheck:
|
|
test:
|
|
[
|
|
"CMD-SHELL",
|
|
"sh -c 'pg_isready -U $${POSTGRES_USER} -d $${POSTGRES_DB}'",
|
|
]
|
|
interval: 5s
|
|
timeout: 5s
|
|
retries: 10
|
|
|
|
hoppscotch-aio:
|
|
container_name: hoppscotch-aio
|
|
restart: unless-stopped
|
|
build:
|
|
dockerfile: prod.Dockerfile
|
|
context: .
|
|
target: aio
|
|
environment:
|
|
DATABASE_URL: postgresql://postgres:${POSTGRES_PASSWORD:-testpass}@hoppscotch-db:5432/${POSTGRES_DB:-hoppscotch}
|
|
env_file:
|
|
- ./.env
|
|
depends_on:
|
|
hoppscotch-db:
|
|
condition: service_healthy
|
|
command:
|
|
[
|
|
"sh",
|
|
"-c",
|
|
"pnpm exec prisma migrate deploy && node /usr/src/app/aio_run.mjs",
|
|
]
|
|
ports:
|
|
- "3000:3000"
|
|
- "3100:3100"
|
|
- "3170:3170"
|
|
- "3200:3200"
|
|
- "3080:80"
|
|
|
|
volumes:
|
|
hoppscotch-db:
|
|
```
|
|
|
|
- [ ] **Step 2: Delete internal deploy compose**
|
|
|
|
Run:
|
|
|
|
```bash
|
|
rm -f docker-compose.deploy.yml
|
|
```
|
|
|
|
Expected: `test ! -f docker-compose.deploy.yml` exits with status 0.
|
|
|
|
### Task 4: Remove Non-Coolify Root Files And Update Docs
|
|
|
|
**Files:**
|
|
- Delete: `firebase.json`
|
|
- Delete: `firestore.indexes.json`
|
|
- Delete: `firestore.rules`
|
|
- Delete: `netlify.toml`
|
|
- Delete: `CODEOWNERS`
|
|
- Delete: `CODE_OF_CONDUCT.md`
|
|
- Delete: `CONTRIBUTING.md`
|
|
- Delete: `SECURITY.md`
|
|
- Delete: `TRANSLATIONS.md`
|
|
- Modify: `README.md`
|
|
- Modify: `.dockerignore`
|
|
|
|
- [ ] **Step 1: Delete unused root files**
|
|
|
|
Run:
|
|
|
|
```bash
|
|
rm -f firebase.json firestore.indexes.json firestore.rules netlify.toml CODEOWNERS CODE_OF_CONDUCT.md CONTRIBUTING.md SECURITY.md TRANSLATIONS.md
|
|
```
|
|
|
|
- [ ] **Step 2: Replace README with Coolify-focused content**
|
|
|
|
Use a short README covering local compose and Coolify variables.
|
|
|
|
- [ ] **Step 3: Keep Docker context lean**
|
|
|
|
Update `.dockerignore` so it excludes local files, build outputs, package test
|
|
artifacts, docs, and removed platform files while keeping source and lockfiles.
|
|
|
|
### Task 5: Validate And Commit
|
|
|
|
**Files:**
|
|
- Verify all modified files
|
|
|
|
- [ ] **Step 1: Check references to removed packages**
|
|
|
|
Run:
|
|
|
|
```bash
|
|
rg -n "hoppscotch-(desktop|agent|cli|relay)|@hoppscotch/cli|docker-compose.deploy|firebase|netlify" .
|
|
```
|
|
|
|
Expected: no deployment-relevant references remain. Historical references in
|
|
lockfile may remain until `pnpm install` updates the lockfile.
|
|
|
|
- [ ] **Step 2: Validate compose syntax**
|
|
|
|
Run:
|
|
|
|
```bash
|
|
docker compose config
|
|
```
|
|
|
|
Expected: command exits 0 and prints a normalized compose config.
|
|
|
|
- [ ] **Step 3: Update lockfile if possible**
|
|
|
|
Run:
|
|
|
|
```bash
|
|
pnpm install --lockfile-only
|
|
```
|
|
|
|
Expected: command exits 0 and removes deleted packages from `pnpm-lock.yaml`.
|
|
|
|
- [ ] **Step 4: Commit**
|
|
|
|
Run:
|
|
|
|
```bash
|
|
git add -A
|
|
git add -f docs/superpowers/specs/2026-05-06-coolify-aio-cleanup-design.md docs/superpowers/plans/2026-05-06-coolify-aio-cleanup.md
|
|
git commit -m "chore: trim repo for coolify aio"
|
|
```
|