EstiMaker/ci-new-app-checklist.md

New App Checklist (Vite + Bun + PM2)

1) Local Repo Changes

• Add serve script:
  • "serve": "serve -s dist -l tcp://0.0.0.0:$PORT"
• Add dependency:
  • serve (run bun add serve)

2) CI Workflow

• Use the template file in ci-template.yaml.
• Replace placeholders:
  • <APP_NAME>
  • <APP_PORT>
  • <DEPLOY_PATH>

3) Server One-Time Setup

• Create deploy directory:
  • mkdir -p <DEPLOY_PATH>
• First PM2 start:
  • cd <DEPLOY_PATH>
  • PORT=<APP_PORT> pm2 start "bun run serve" --name <APP_NAME>
  • pm2 save

4) Deploy + Restart (CI will do this)

• Files copied to server:
  • dist/, package.json, bun.lock (or bun.lockb)
• On server:
  • bun install --production
  • PORT=<APP_PORT> pm2 restart <APP_NAME> --update-env

5) Verification

• PM2 process:
  • pm2 show <APP_NAME>
• Port:
  • pm2 env <ID> | grep PORT
• Bind:
  • pm2 logs <APP_NAME> --lines 20
  • Expect: Accepting connections at http://0.0.0.0:<APP_PORT>
• Files:
  • ls -la <DEPLOY_PATH>
  • ls -la <DEPLOY_PATH>/dist | head -20
• HTTP:
  • curl -I http://<SERVER_IP>:<APP_PORT>