Releases

Releases are versioned builds of your product stored on Cloudflare R2. Published releases are available for download and WordPress auto-updates.

Uploading a Release

Via Dashboard

1. Go to your product's detail page
2. Click the Releases tab
3. Click New Release
4. Upload your ZIP file and set the version number
5. Add release notes (optional)
6. Choose status: Draft or Published

Via API

Upload the file first, then create the release record:

# Step 1: Upload the ZIP
curl -X POST https://api.packedge.dev/api/products/:id/releases/upload \
  -H "Cookie: session=YOUR_SESSION" \
  -F "[email protected]" \
  -F "version=1.0.0"

# Step 2: Create the release
curl -X POST https://api.packedge.dev/api/products/:id/releases \
  -H "Content-Type: application/json" \
  -H "Cookie: session=YOUR_SESSION" \
  -d '{
    "version": "1.0.0",
    "releaseNotes": "Initial release",
    "filePath": "my-plugin/1.0.0/my-plugin-1.0.0.zip",
    "fileName": "my-plugin-1.0.0.zip",
    "fileSize": 12345,
    "status": "published"
  }'

Release Status

Status	Description
draft	Not available for download or auto-updates
published	Available for download and WordPress update checks

Versioning

Releases use semantic versioning. The WordPress update check compares the installed version against the latest published release using semver.

Storage

Release files are stored in Cloudflare R2 at the path:

{product-slug}/{version}/{filename}.zip

Downloads are streamed directly from R2 with automatic download count tracking.