Overview
Work in your org
Once your User Story is started, you work in your dev sandbox or scratch org like in any other org: Salesforce Setup for configuration, VS Code for code. A few guidelines make the life of the release manager easier and avoid regressions when your work is deployed to the other orgs.
- Open your org: open the org linked to your User Story from VS Code.
- Configuration guidelines: API names, access management, Flows, hardcoded Ids, images, user references.
- Profiles and Permission Sets: why Permission Sets come first, and the Profile attributes that need special care.
- Development guidelines: push and pull code between VS Code and your org.
- Install packages: register the packages installed in your org so the CI server installs them everywhere.
- Deployment actions: declare the steps that must run before or after the deployment of your User Story (data loads, Apex scripts, Experience Cloud publishing, scheduled batches, manual steps).
When you are done, publish your User Story.
If your colleagues merged changes in the meantime, Backpromote (Beta) brings them into your dev sandbox or scratch org, so you work on an up-to-date org: it reads what your sandbox already received from the Pull Request comments, deploys what was merged since, runs the deployment actions of those Pull Requests, and gives you one decision for each file that differs in your sandbox (overwrite, keep the org version, or merge with the VS Code merge editor or a coding agent prompt). In VS Code, the Backpromote (Beta) panel shows the Pull Requests, the items, the deletions and the deployment actions, lets you untick what you do not want yet, and runs it in one click.
Video walkthrough
This recording shows how to work on a User Story in a source-tracked sandbox. It was recorded with the previous interface of the extension: the screens have changed, the steps have not.