Guides

Practical, end-to-end recipes.

Firmware integration

• Arduino integration: SimpleOTAClient library (recommended) or raw HTTPUpdate.
• ESP-IDF integration: esp_https_ota against the device API.
• Manifest schema: the sidecar JSON reference.
• Device tokens: project-scoped and per-device token management.

CI/CD

• GitHub Actions: build + upload on tag push.
• GitLab CI: same flow, GitLab edition.

Deployment management

• Promoting deployments: canary → 25% → 100%.
• Pausing deployments: when something is on fire.
• Trial install and rollback: on-device trial mechanics and confirm patterns (Arduino, v0.2.0+).