All plugin operations — install, update, and uninstall — trigger a build process. After starting an operation, Portal displays a build progress dialog that walks through the following stages:Documentation Index
Fetch the complete documentation index at: https://backstage.spotify.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
Only one build can be in progress at a time. If you attempt to start a new
operation while a build is already running, Portal will show the existing
in-progress build instead.
| Stage | Description |
|---|---|
| Waiting | Build is queued and waiting to start |
| Analyzing | Analyzing package dependencies |
| Downloading | Downloading packages |
| Installing | Installing packages |
| Building | Building Portal with the updated packages |
| Saving | Saving build artifacts |
| Complete | Build finished successfully |
Viewing an In-Progress Build
If you navigate away from the build dialog, you can return to it at any time. The Plugin Settings page displays a banner when a build is in progress — click View to reopen the build progress dialog.
If a Build Fails
If the build encounters an error, the dialog will display the failure reason along with any per-package error details.
- Edit packages — adjust package names or versions and retry the operation
- Cancel — discard the operation and return to Plugin Settings
Cancelling a Build
You can cancel a build while it is in progress by clicking Cancel in the build dialog. You will be asked to confirm before the build is stopped.