Previews per branch
Every branch of the Frontend has its own preview: the app running with the code of that branch. When you switch branches, the preview switches with you. While Archie applies your changes, you see Updating preview of branch. If the preview could not refresh, you see The preview of branch did not update.- Deleting a branch removes its preview. What you already published stays available to publish again.
- Sleeping previews. Your organization can have a limited number of previews running at once. A preview with no activity for a while goes to sleep. Open it to wake it, and the least active preview goes to sleep instead.
The environment of a branch
A preview needs data, and data lives in an environment. A new branch uses the backend environment of the project until you change it. To connect a branch to a different environment:- Switch to the branch and open the branch menu.
- In Backend, select Change. This opens the backend environment control in the header.
- Pick an environment. The dialog shows readiness checks for it and tells you if the switch is blocked.
- Confirm Connect branch to environment? with Connect.
Two branches connected to the same environment share its data. See Branches and environments.
Share a preview
A share link lets anyone see your work in progress without access to the project. Owners and Editors can create links from the Frontend.- In the project header, select Share, then Share preview.
- Select Create new preview link.
- In Create preview link, check the details:
- Branch @ commit is the latest commit of the branch you are on.
- Backend is the environment the link reads data from.
- Name defaults to branch@commit. You can change it, for example to Client demo.
- Expires is 1 hour, 24 hours, 3 days, 7 days, or a custom date and time.
- Select Create link. Archie copies the link so you can share it.
- While Archie builds the snapshot, you see Building…. Keep the window open until it is ready. Archie creates the link automatically. If the build fails, select Retry.
- If the branch has edits that are not in a commit yet, the dialog tells you which commit it will share.
- Right after a merge into a protected branch, sharing waits until the branch finishes updating.
- To stop a link, select Revoke and confirm Revoke link. Guests lose access within seconds. If it was the only link to that snapshot, Archie deletes the snapshot too.
- Shared links count toward the capacity of your organization’s plan. When you reach it, you can remove a link or add capacity.
Publish the Frontend
Publishing is explicit. Select Publish in the project header to open Publish site: “Choose the branch and commit that go live.”
If the site would read data from an environment that is not the root environment, Publish stays disabled until you type the name of the environment. This keeps you from publishing against the wrong data.
Publications lists earlier publishes with their status: Live, Replaced, Failed, or Publishing…. Select Publish this again to republish an earlier one. If the environment changed since then, the entry tells you what it read back then and what it will read now.
Who can publish depends on the Who can publish setting. See Permissions.