deploy-safely v1.0.0A

Immutable. This exact content is served forever at /api/v1/blob/e1103074806d4f93.

---
name: deploy-safely
description: Build, test, deploy, and verify with rollback on failure.
metadata:
  version: "1.0.0"
---

# Deploy Safely

Build, test, deploy, and verify with rollback on failure.

## Steps

1. **Build**
   ```bash
   veryfront build --json
   ```
   Abort if `success: false`.

2. **Run tests**
   ```bash
   veryfront test --json
   ```
   Abort if any test fails.

3. **Deploy**
   ```bash
   veryfront deploy --env <environment> --branch <branch> --yes --json
   ```
   Record the release version from the response.

4. **Verify health** (via MCP)
   Use `vf_get_errors` to check for runtime errors after deploy.
   Wait 30 seconds, then check again.

5. **Confirm or rollback**
   - If no errors: deployment is successful
   - If errors detected: deploy the previous version

## Error Recovery

- **Build fails**: Check `vf_get_errors` for compilation errors, fix and retry
- **Tests fail**: Read failure details from JSON output, fix failing tests
- **Deploy fails**: Check environment name, auth token, branch existence
- **Post-deploy errors**: Redeploy previous release with `--release-name <previous>`