From 28ea024bf0238db7a05a3d4913b74d50264dd1b0 Mon Sep 17 00:00:00 2001 From: Adam Matthiesen Date: Thu, 5 Feb 2026 21:34:47 -0800 Subject: [PATCH 1/2] feat: add upgrade guide for v0.3.0 with breaking changes and improvements --- .../guides/upgrade/version-guides/0-2-0.mdx | 3 -- .../guides/upgrade/version-guides/0-3-0.mdx | 32 +++++++++++++++++++ src/content/docs/en/how-it-works/index.mdx | 1 - 3 files changed, 32 insertions(+), 4 deletions(-) create mode 100644 src/content/docs/en/guides/upgrade/version-guides/0-3-0.mdx diff --git a/src/content/docs/en/guides/upgrade/version-guides/0-2-0.mdx b/src/content/docs/en/guides/upgrade/version-guides/0-2-0.mdx index 3f6e34cb..e8a11407 100644 --- a/src/content/docs/en/guides/upgrade/version-guides/0-2-0.mdx +++ b/src/content/docs/en/guides/upgrade/version-guides/0-2-0.mdx @@ -5,9 +5,6 @@ description: Upgrade StudioCMS to v0.2.0 topic: guides sidebar: label: v0.2.0 - badge: - text: NEW - variant: success order: 999982 --- diff --git a/src/content/docs/en/guides/upgrade/version-guides/0-3-0.mdx b/src/content/docs/en/guides/upgrade/version-guides/0-3-0.mdx new file mode 100644 index 00000000..17ec77d5 --- /dev/null +++ b/src/content/docs/en/guides/upgrade/version-guides/0-3-0.mdx @@ -0,0 +1,32 @@ +--- +i18nReady: true +title: "Upgrade: v0.3.0" +description: Upgrade StudioCMS to v0.3.0 +topic: guides +sidebar: + label: v0.3.0 + badge: + text: NEW + variant: success + order: 999981 +--- + +import QuickUpdate from '~/components/QuickUpdate.astro' + + + +## Breaking changes + +- Removes the following deprecated and unused virtual modules. + - `studiocms:astro-config/adapter` + - `studiocms:auth/utils/getLabelForPermissionLevel` + - `virtual:studiocms/sdk/env` + +## Bug Fixes & Improvements + +- Replaces `chalk` with `node:util`'s `styleText` for StudioCMS CLI. +- updates StudioCMS dependencies +- Fixes issue with `pg` and `mysql2` being required to be installed when they should be optional +- Fix client regex in frontend to allow for slashes within a slug, but not on the outside. This unblocks creating pages under sub-paths just using the slug (e.g., `docs/getting-started`) and only affects client-side validation. +- Removes legacy email domain verification code +- Fixes default 404 route rendering \ No newline at end of file diff --git a/src/content/docs/en/how-it-works/index.mdx b/src/content/docs/en/how-it-works/index.mdx index ef724353..c60188ef 100644 --- a/src/content/docs/en/how-it-works/index.mdx +++ b/src/content/docs/en/how-it-works/index.mdx @@ -22,7 +22,6 @@ The StudioCMS integration provides several [virtual modules](https://vite.dev/gu - **`studiocms:auth/lib`**: Authentication utilities for StudioCMS. - **`studiocms:auth/utils/authEnvCheck`**: Utilities for checking the authentication environment for StudioCMS. -- **`studiocms:auth/utils/getLabelForPermissionLevel`**: Utilities for getting the label for a permission level for StudioCMS. - **`studiocms:auth/utils/validImages`**: Valid images used on the StudioCMS login page. - **`studiocms:auth/scripts/three`**: Three.js scripts for the StudioCMS login page. From d5a8028464fc6e028c6b732a4d4c9eee861c414d Mon Sep 17 00:00:00 2001 From: Adam Matthiesen Date: Thu, 5 Feb 2026 21:46:03 -0800 Subject: [PATCH 2/2] fix: correct typos and formatting in upgrade guide for v0.3.0 --- src/content/docs/en/guides/upgrade/version-guides/0-3-0.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/content/docs/en/guides/upgrade/version-guides/0-3-0.mdx b/src/content/docs/en/guides/upgrade/version-guides/0-3-0.mdx index 17ec77d5..242c71cd 100644 --- a/src/content/docs/en/guides/upgrade/version-guides/0-3-0.mdx +++ b/src/content/docs/en/guides/upgrade/version-guides/0-3-0.mdx @@ -25,8 +25,8 @@ import QuickUpdate from '~/components/QuickUpdate.astro' ## Bug Fixes & Improvements - Replaces `chalk` with `node:util`'s `styleText` for StudioCMS CLI. -- updates StudioCMS dependencies +- Updates StudioCMS dependencies. - Fixes issue with `pg` and `mysql2` being required to be installed when they should be optional -- Fix client regex in frontend to allow for slashes within a slug, but not on the outside. This unblocks creating pages under sub-paths just using the slug (e.g., `docs/getting-started`) and only affects client-side validation. +- Fixes client regex in frontend to allow for slashes within a slug, but not on the outside. This unblocks creating pages under sub-paths just using the slug (e.g., `docs/getting-started`) and only affects client-side validation. - Removes legacy email domain verification code - Fixes default 404 route rendering \ No newline at end of file