Skip to content

Remove deprecated --force flag from shopify app release#7521

Open
alfonso-noriega wants to merge 1 commit into
01-remove-app-deploy-force-flagfrom
02-remove-app-release-force-flag
Open

Remove deprecated --force flag from shopify app release#7521
alfonso-noriega wants to merge 1 commit into
01-remove-app-deploy-force-flagfrom
02-remove-app-release-force-flag

Conversation

@alfonso-noriega
Copy link
Copy Markdown
Contributor

@alfonso-noriega alfonso-noriega commented May 11, 2026

WHY are these changes introduced?

The --force (-f) flag and SHOPIFY_FLAG_FORCE environment variable on shopify app release have been deprecated for some time (the command currently renders a deprecation warning when they're used). Users have been pointed to --allow-updates / --allow-deletes. This PR removes the deprecated flag and its dead-code paths in preparation for the next major release.

Part of the deprecated-flag-removal stack: #7520 ← this PR → #7522.

WHAT is this pull request doing?

  • Removes the --force/-f flag definition and the SHOPIFY_FLAG_FORCE env binding from shopify app release.
  • Removes the runtime deprecation warning and the deprecation-warning-only test file (packages/app/src/cli/commands/app/release.test.ts).
  • Derives the internal force (skip-confirmation-prompt) parameter passed to the release service as --allow-updates && --allow-deletes, preserving the prior --force semantics: passing both flags skips the prompt.
  • Updates the non-TTY required-flag check to reflect that --allow-updates or --allow-deletes are now the only ways to release in CI.
  • Regenerates packages/cli/oclif.manifest.json, packages/cli/README.md, and docs-shopify.dev/commands/interfaces/app-release.interface.ts.

How to test your changes?

  1. Run pnpm shopify app release --version v1.0.0 --force and confirm it now fails with an unknown-flag error.
  2. Run pnpm shopify app release --help and confirm -f, --force is no longer listed.
  3. Run pnpm shopify app release --version v1.0.0 --allow-updates --allow-deletes against an app and confirm the prompt is skipped (matching the previous --force behavior).
  4. Run pnpm shopify app release --version v1.0.0 --allow-updates and confirm the prompt still appears for deletes if any, as before.

Checklist

  • I've considered possible cross-platform impacts (Mac, Linux, Windows)
  • I've considered possible documentation changes
  • I've considered analytics changes to measure impact
  • The change is user-facing — I've identified the correct bump type (patch for bug fixes · minor for new features · major for breaking changes) and added a changeset with pnpm changeset add

Copy link
Copy Markdown
Contributor Author

alfonso-noriega commented May 11, 2026

The --force (-f) flag and SHOPIFY_FLAG_FORCE env var on `shopify app release`
were deprecated in favor of --allow-updates / --allow-deletes. This change
removes them along with the related deprecation warning and tests.

The internal `force` (skip-confirmation-prompt) parameter passed to the
release service is now derived as `--allow-updates && --allow-deletes`,
preserving the prior semantics: passing both flags skips the prompt.
@alfonso-noriega alfonso-noriega force-pushed the 02-remove-app-release-force-flag branch from 3ba2c87 to c36d5c2 Compare May 11, 2026 12:52
@alfonso-noriega alfonso-noriega force-pushed the 01-remove-app-deploy-force-flag branch from e126ffb to 96281e6 Compare May 11, 2026 12:52
@alfonso-noriega alfonso-noriega temporarily deployed to breaking-change-approval May 11, 2026 12:53 — with GitHub Actions Inactive
@alfonso-noriega alfonso-noriega temporarily deployed to breaking-change-approval May 11, 2026 13:57 — with GitHub Actions Inactive
@github-actions
Copy link
Copy Markdown
Contributor

⚠️ Potential Breaking Changes Detected

This PR contains changes that may break the existing contract.

@shopify/dev_experience — this PR contains breaking changes that require coordination for the next major release. This check will remain failed until a member of the team approves the workflow run.

💬 Head to #help-dev-platform to discuss timing and plan the release.

📦 Major Version Changesets

The following changesets request a major version bump:

Changeset Package
remove-app-deploy-force-flag.md '@shopify/app': major
remove-app-release-force-flag.md '@shopify/app': major
thin-webs-notice.md '@shopify/plugin-did-you-mean': major
thin-webs-notice.md '@shopify/plugin-cloudflare': major
thin-webs-notice.md '@shopify/create-app': major
thin-webs-notice.md '@shopify/cli-kit': major
thin-webs-notice.md '@shopify/store': major
thin-webs-notice.md '@shopify/theme': major
thin-webs-notice.md '@shopify/app': major
thin-webs-notice.md '@shopify/cli': major
thin-webs-notice.md '@shopify/e2e': major

🏳️ Removed Flags

The following flags were removed from existing commands:

Command Flag
app:release --force

@alfonso-noriega alfonso-noriega deployed to breaking-change-approval May 11, 2026 14:35 — with GitHub Actions Active
@alfonso-noriega alfonso-noriega marked this pull request as ready for review May 11, 2026 15:14
@alfonso-noriega alfonso-noriega requested review from a team as code owners May 11, 2026 15:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Area: @shopify/app @shopify/app package issues

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants