What problem does it solve?
Manually uploading Nova-generated Learn and Deliver apps to CommCare HQ is time-consuming and error-prone, with risks of targeting the wrong project space or missing unescaped XML metacharacters that cause build failures. This skill automates the entire deployment workflow, ensuring apps are uploaded correctly as drafts, all required metadata is captured, and downstream phases have the information they need to proceed.
Core Features & Use Cases
- Pre-flight Project Space Validation: Confirms the target CommCare HQ project space is correctly configured before upload, preventing accidental uploads to the wrong environment.
- XML Form Linting: Scans all app forms for unescaped XML metacharacters in labels, hints, and options that would cause build failures, fixing issues automatically before upload.
- Automated Draft Upload: Uses the Nova plugin to upload both Learn and Deliver apps as draft builds to the configured CommCare HQ project, with clear error handling for domain authorization and upload failures.
- Structured Artifact Generation: Writes a deployment summary with app IDs and URLs, and atomically updates the run state with consolidated app metadata for use by downstream phases like app release and payment unit configuration.
- Use Case: For a Connect opportunity, after Nova generates the Learn and Deliver apps, run this skill to automatically deploy them to CommCare HQ, capture all required IDs and URLs, and make the metadata available for the rest of the ACE lifecycle without manual intervention.
Quick Start
Use the app-deploy skill to upload your Nova-built Learn and Deliver apps to the configured CommCare HQ project space and generate the deployment summary with all required app IDs and URLs.