Salesforce Release Center
Salesforce Release Center is a VS Code extension for Git-aware Salesforce metadata releases. It combines sfdx-git-delta, Salesforce CLI, and VS Code views to help you generate, review, validate, deploy, retrieve, and back up metadata from one workspace.
Features
- Generate a metadata delta from a Git branch or commit using
sfdx-git-delta
- Review added, modified, and deleted metadata in the Changed Files tree
- Select a target Salesforce Org with environment and branch mapping
- Configure Apex test mappings and use automatic test-class matching
- Deploy the exact SGD-generated
package.xml and destructive changes manifest
- Validate production deployments and use Quick Deploy when Salesforce allows it
- Fall back to a normal deployment for non-Apex packages that cannot Quick Deploy
- Preview generated metadata files and deployment contents
- View deployment progress in notifications, the sidebar, Output, and native Test Results
- Keep deployment history with timestamps, Job IDs, errors, and manifest XML
- Back up Org metadata to the project source directory or
backupPackage
Requirements
Visual Studio Code 1.129.0 or later
Salesforce CLI (sf)
Git
The Salesforce CLI sfdx-git-delta plugin:
sf plugins install sfdx-git-delta
An authenticated Salesforce Org:
sf org login web --alias my-org
Getting Started
- Open an SFDX project containing
sfdx-project.json.
- Open the Salesforce Release Center view from the Activity Bar.
- Select a Target Org. Its mapped Target Branch is filled automatically when configured.
- Run Generate Diff from Branch or Generate Diff from Commit.
- Review Changed Files and configure test mappings when Apex is included.
- Use Deploy to Target Org, Validate Only, or Validate & Deploy.
Project Configuration
Project settings are stored under .sfdeploy/ and should be reviewed before sharing with a team. VS Code settings use the sfdevops.* namespace and control confirmation dialogs, source directories, generated output, and history retention.
The default generated output directory is:
changed-sources/
The extension always uses the manifest produced by SGD for deployment and validation. It does not rebuild the package manifest from inferred file names.
Deployment Behavior
- Sandbox deployments use
sf project deploy start.
- Production deployments containing Apex classes or triggers require specified tests when no explicit test level is selected.
- Production deployments without Apex use Salesforce's package-aware behavior for direct deployment.
- Validation uses
RunRelevantTests for packages without ApexClass or ApexTrigger.
- A validation that did not run tests cannot be Quick Deployed, so the extension automatically performs a normal deployment instead.
- Destructive changes are passed using the destructive manifest generated by SGD.
Development
npm install
npm run lint
npx tsc --noEmit
npm run compile
Press F5 in VS Code to launch an Extension Development Host.
Packaging
Install the official packaging tool and create a local VSIX:
npm install -g @vscode/vsce
vsce package
Inspect the package before publishing:
vsce ls
Privacy and Security
The extension does not include a runtime npm dependency or transmit metadata to a third-party service. It invokes locally installed git, sf, and sfdx-git-delta commands. Salesforce credentials remain managed by Salesforce CLI.
License
MIT
