Skip to content

A local-first personal finance app

[AI] Update preview-builds doc with current URL pattern and additional previews (#7728)

Nikhil Verma9e9cf4564139
diff --git a/packages/docs/docs/contributing/preview-builds.md b/packages/docs/docs/contributing/preview-builds.md
index 1708ecf561..c0a98aa25f 100644
--- a/packages/docs/docs/contributing/preview-builds.md
+++ b/packages/docs/docs/contributing/preview-builds.md
@@ -1,12 +1,16 @@
# Preview Builds
-It is possible using our deployment pipeline to run preview builds of Actual directly on Netlify.
+Each pull request automatically deploys preview builds to Netlify, so you can try out changes without cloning the branch.
-To do this, find the pull request (PR) that you would like to preview in GitHub, you can find the pull requests in scope of the preview builds [here](https://github.com/actualbudget/actual/pulls).
+To find a PR, browse the [open pull requests](https://github.com/actualbudget/actual/pulls). Once you have the PR number, replace `{pr-number}` in the URLs below.
-Once you have the number of the PR navigate to the following URL: https://deploy-preview-pr_number--actualbudget.netlify.app/ replacing pr_number with the number of the PR you would like to preview, for example https://deploy-preview-414--actualbudget.netlify.app/
+Three previews are deployed per PR:
-This will load directly on Netlify where you will be able to preview the changes in that pull request without the need to clone the specific branch.
+- **Demo:** `https://deploy-preview-{pr-number}.demo.actualbudget.org/`
+- **Storybook:** `https://deploy-preview-{pr-number}--actualbudget-storybook.netlify.app/`
+- **Website:** `https://deploy-preview-{pr-number}.www.actualbudget.org/`
+
+The exact URLs are also posted as a comment on each PR by the Netlify bot.
:::info
There is no sync server on preview builds so when asked "Where's the server" select "Don't use a server." Alternatively, you can use your own self-hosted server. You should exercise caution when using a server with preview builds because they are much more likely to have bugs that could damage your budget. Consider running a separate local server for preview builds.
diff --git a/upcoming-release-notes/7728.md b/upcoming-release-notes/7728.md
new file mode 100644
index 0000000000..1448277386
--- /dev/null
+++ b/upcoming-release-notes/7728.md
@@ -0,0 +1,6 @@
+---
+category: Maintenance
+authors: [nikhilweee]
+---
+
+Update the preview-builds contributing doc to reflect the current `deploy-preview-{pr-number}.demo.actualbudget.org` URL pattern and mention the Storybook and website previews.