Skip to content

Cloud skill: promote to GA, document missing/outdated CLI surface - #48

Merged
jallegretti-webflow merged 2 commits into
mainfrom
jonathanallegretti/cloud-skill-deployments-wait
Sep 17, 2026
Merged

jallegretti-webflow merged 2 commits into
mainfrom
jonathanallegretti/cloud-skill-deployments-wait

Conversation

@jallegretti-webflow

@jallegretti-webflow jallegretti-webflow commented Sep 15, 2026 •

Copy link
Copy Markdown
Contributor

What

Rewrites the Webflow Cloud CLI skill for the GA state of webflow apps — this PR assumes the namespace and every gate within it (the deploy --json/--dry-run flags, apps link/update/delete/environments create/update/delete, and the vite/static scaffolds) are fully promoted to @latest. Do not merge until that's actually true on webflow-cli@latest.

Beta → GA framing removed:

  • The whole "Beta: webflow apps requires @next" section, the "Namespaces" comparison table's beta framing, and the "Beta gating tiers" table
  • The "Managing apps" beta banner and every inline "(beta, apps only)" callout
  • Install instructions and the GitHub Actions example now use @latest, not @next

Missing features added:

  • apps deployments trigger/redeploy gained --wait/--interval/--timeout (CLOUD-738) — only deployments get was documented
  • apps deploy gained --dry-run/--json (CLOUD-737) — the skill said deploy had neither; added to the flags table with the actual output shape
  • apps update/apps delete --json output shapes were never documented (CLOUD-739/CLOUD-746 added structured output, the skill only showed the flag)
  • vite and static frameworks — both already buildable, vite also scaffoldable via apps init — weren't mentioned anywhere (Frameworks table, required-flags matrix, --framework flag descriptions, troubleshooting, scaffold repo list)
  • sourceUrl missing from apps list/apps get's documented field set

Outdated facts fixed:

  • apps environments list's default/all fields still said deployUrl; renamed to publicUrl a while ago (CLOUD-693)
  • Cloudflare binding limit ("max 5 of each type") was removed from the CLI a while back — storage is now entitlement-governed, not hardcoded
  • webflow cloud list's deprecation warning wasn't mentioned

Version bump 1.0.8 → 1.0.9 (patch) across the three plugin manifests, per this repo's convention — unchanged from the original commit on this branch.

Why

Found while reconciling a Webflow Cloud CLI changelog (CLOUD-159) against actual webflow-cli source — the same commands kept turning up documented incompletely or incorrectly in this skill too. Scope expanded from the original --wait fix to a full pass once the pattern repeated.

QA Spec

  • Confirm webflow apps (and every sub-gate: link/update/delete/environments-write, vite/static scaffolds) is actually GA on @latest before merging — this PR's entire framing depends on it
  • Command/flag names and output shapes spot-checked against webflow/webflow-cli@main
  • SKILL.md renders correctly; internal anchor links resolve

…-run

- apps deployments trigger/redeploy were missing --wait/--interval/--timeout
  (added alongside redeploy in webflow-cli CLOUD-738); documented with the
  same client-side "identify then poll" mechanism as deployments get --wait.
- Known limitations claimed apps deploy has neither --dry-run nor --json.
  Both landed on the apps form (not the cloud alias) via CLOUD-737, before
  this skill's last update — added to the flags table with the actual
  output shapes and corrected the limitations section.
- Bump plugin manifests 1.0.8 -> 1.0.9 (patch) per repo convention.
@jallegretti-webflow jallegretti-webflow self-assigned this Sep 15, 2026
@jallegretti-webflow
jallegretti-webflow marked this pull request as ready for review September 15, 2026 14:51
- Remove all beta/@next framing: the top "Beta" section, the "Namespaces"
  comparison table, the "Beta gating tiers" table, the "Managing apps"
  beta banner, and every inline "(beta, apps only)" callout. Install
  instructions and the GitHub Actions example now use @latest.
- Add vite and static as supported frameworks throughout (flags tables,
  required-flag matrix, troubleshooting, scaffold repo list) — both build
  and (for vite) init-scaffold support already exist in webflow-cli,
  just weren't documented here.
- Fix apps environments list's stale `deployUrl` field name to `publicUrl`
  (renamed via CLOUD-693, before this skill's last update).
- Add missing `sourceUrl` to apps list/get's full field set, and document
  it as the connected GitHub source.
- Remove the stale "max 5 of each type" Cloudflare binding limit (removed
  from the CLI a while ago; storage is now entitlement-governed).
- Document apps update/apps delete --json output shapes, which weren't
  described at all (CLOUD-739/CLOUD-746 added structured output but the
  skill only showed the flag, not the shape).
- Note webflow cloud list's deprecation warning.
@jallegretti-webflow jallegretti-webflow changed the title Cloud skill: document apps deployments --wait and deploy --json/--dry-run Cloud skill: promote to GA, document missing/outdated CLI surface Sep 15, 2026
@jallegretti-webflow
jallegretti-webflow merged commit fccbe8f into main Sep 17, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants