Skip to content

feat: add upgrade guide for v0.3.0 with breaking changes and improvements #214

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Adammatthiesen merged 2 commits into from
Feb 7, 2026
Merged

feat: add upgrade guide for v0.3.0 with breaking changes and improvements #214

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
28ea024
feat: add upgrade guide for v0.3.0 with breaking changes and improvem…
Adammatthiesen Feb 6, 2026
d5a8028
fix: correct typos and formatting in upgrade guide for v0.3.0
Adammatthiesen Feb 6, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 0 additions & 3 deletions src/content/docs/en/guides/upgrade/version-guides/0-2-0.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
---

Expand Down
32 changes: 32 additions & 0 deletions src/content/docs/en/guides/upgrade/version-guides/0-3-0.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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'

<QuickUpdate />

## 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
- 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
1 change: 0 additions & 1 deletion src/content/docs/en/how-it-works/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down