New application checklist

Use this when adding a new project (e.g. bioscan/shop, user repos under rafael.gonzalez.albes).

Static site only (IONOS SFTP)

1. Onboard — bash scripts/onboard-project.sh --profile static-sftp ... (see Onboard project)
2. Forgejo — repo must exist under org or user namespace
3. Copy templates/woodpecker-static-sftp.yml → .woodpecker.yml (if not already)
4. Append notify steps from templates/woodpecker-notify-plane.yml
5. Secrets — local/projects/<repo>.env for SFTP; onboard script pushes to Woodpecker
6. Push main and verify deploy

Full-stack (frontend SFTP + backend VPS)

1. Steps above for frontend
2. DNS — {app}-api.{domain} → VPS
3. Repo — add deploy/docker-compose.yml (see templates/woodpecker-frontend-backend.yml)
4. VPS — /opt/apps/{app}/ with .env
5. Woodpecker secrets: shared ssh_host, ssh_user, ssh_key + registry tokens

Staging (later)

• develop branch → staging-{app}-api.* + SFTP folder {app}-staging
• main branch → production

Not configured yet — production-only for now.

Examples on this infrastructure

App	Repo	SFTP path	URL
portfolio	rafael.gonzalez.albes/portfolio	dist/	rafaelgonzalezalbes.com
bioscancheck	bioscan/bioscancheck	TBD	TBD
timbertails	manual	timbertails/	timbertails.rafaelgonzalezalbes.com
airportConnection	manual	airportconnection/	subdomain