Skip to content

feat(skills): document webflow apps commands#37

Draft
agustinchiarotto wants to merge 2 commits into
mainfrom
feat/document-webflow-apps-commands
Draft

feat(skills): document webflow apps commands#37
agustinchiarotto wants to merge 2 commits into
mainfrom
feat/document-webflow-apps-commands

Conversation

@agustinchiarotto

Copy link
Copy Markdown

Summary

Documents the canonical webflow apps namespace in the Webflow Cloud CLI skill (plugins/webflow-skills/skills/webflow-cloud-command/SKILL.md) and refreshes stale cloud-namespace content. Command surface mirrors apps.ts / registerAppCommands.ts on webflow-cli main.

  • New "Managing apps" sectionapps list / get / domains, environments list, deployments list / get (with the starting|building|deploying|success|failed|canceled|unstaged status enum, deploying = build-done/deploy-running, pollable-but-no---watch), logs build / runtime (--since / --q / --limit / --cursor, no --level), env-vars list / set / delete / import, and update / delete. Each has a --json example, --fields defaults, the appId/envId resolver precedence, and the --no-input machine-readable missingFlag contract. Read commands derive the workspace server-side (no --workspace-id).
  • Canonical vs deprecatedapps init / apps deploy and --app-name / --app-id presented as canonical; cloud init / deploy / create and --project-name / --project-id marked as deprecated (but working) aliases.
  • Config/detectioncloud.app_id (legacy cloud.project_id still read as fallback), env vars, and the CLD-1960 resolver precedence table.
  • Scaffold ref note corrected (Astro v2 + astro7 betaRef, Next.js v1).

⚠️ Do not merge until CLD-2201 ships

These apps commands only reach stable @latest once the beta gate (if (isBetaBuild()) initApps(program) in cli/webflow.ts) is removed. Hold this PR until that gate removal / prod release lands.

Notes for reviewers

  • apps update / apps delete are documented as stable, but the source keeps them behind a second, independent isBetaBuild() gate inside apps.ts that CLD-2201 does not remove. As written, the docs describe two commands that won't exist in @latest until they're separately promoted. Flagging explicitly — may need a follow-up (either gate them in the docs or promote the commands).
  • Env var for the environment ID is documented as WEBFLOW_APP_ENVIRONMENT_ID (the actual name in resolveResourceId.ts).
  • cloud list is documented as the scaffold-template lister (distinct from apps list), since the code keeps create/list only under the cloud namespace.
  • File is now ~1091 lines, over the 500-line CONTRIBUTING guideline. Not split in this PR — a future split may be warranted.

Test plan

  • CI structural checks pass (frontmatter name: / description: present)
  • Cross-check documented flags/commands against webflow-cli main at release time
  • Re-confirm apps update / apps delete gating decision before un-drafting

Made with Cursor

agustinchiarotto and others added 2 commits July 14, 2026 18:01
Document the canonical `webflow apps` namespace in the Webflow Cloud skill
and refresh stale `cloud`-namespace content.

- Add a "Managing apps" section covering apps list/get/domains, environments
  list, deployments list/get (with the status enum + polling note),
  logs build/runtime, env-vars list/set/delete/import, and update/delete —
  each with a --json example, --fields defaults, the appId/envId resolver
  precedence, and the --no-input missingFlag contract. Read commands derive
  the workspace server-side (no --workspace-id).
- Present `apps init`/`apps deploy` and `--app-name`/`--app-id` as canonical;
  mark `cloud init`/`deploy`/`create` and `--project-name`/`--project-id` as
  deprecated aliases.
- Switch detection/config to `cloud.app_id` (legacy `cloud.project_id` still
  read as a fallback) and document env vars + the CLD-1960 resolver.
- Correct the scaffold ref note (Astro v2 + astro7 betaRef, Next.js v1).

Co-authored-by: Cursor <cursoragent@cursor.com>
- Simplify the scaffold-fetch note to avoid exposing internal versioning/beta
  roadmap details publicly.
- Remove the "standalone" wording in favor of the existing "project app" term.

Co-authored-by: Cursor <cursoragent@cursor.com>

@jallegretti-webflow jallegretti-webflow left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM, all mentions of standalone, beta and @next are removed as this will be released once CLI hits GA 👍

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