Reusable GitHub Actions workflows that deploy containerized web applications to Locaweb Cloud. Provisions CloudStack infrastructure (VMs, networks, disks, firewall rules, snapshots) and deploys containers via Kamal 2 with zero-downtime proxy.
Agent guidance for deploying to this platform lives in Cofounder, which installs a set of skills (including cofounder-app-deploy, the deploy skill for these workflows) into your project for Claude Code and other agents. It is the single source of truth for agent-facing deployment instructions — this repo no longer ships its own skill bundle.
Run the installer from inside your project directory:
/bin/bash -c "$(curl -fsSL https://cofounder.locaweb.com.br/install.sh)"The cofounder-app-deploy skill covers:
- Writing deploy and teardown caller workflows with all available inputs
- Configuring GitHub repo secrets (CloudStack keys, SSH key, Postgres credentials)
- Dockerfile requirements (port 80,
/uphealth check, worker command) - Environment variables and secrets in dotenv format
- VM plan selection and scaling (vertical for web/db, horizontal for workers)
- Disk sizing and growth
- TLS everywhere (automatic Let's Encrypt certificates for nip.io and custom domains)
- Teardown process and operations on live infrastructure
- Platform constraints (single web VM, single Dockerfile, accessory model)