From dc3ad58ae59be229c41c99006406f674c06a54de Mon Sep 17 00:00:00 2001 From: ellielok Date: Fri, 19 Sep 2025 19:26:25 +1000 Subject: [PATCH 1/5] Remove ViewTransitions in v6 --- src/content/docs/en/guides/upgrade-to/v6.mdx | 45 +++++++++++++++++++- 1 file changed, 44 insertions(+), 1 deletion(-) diff --git a/src/content/docs/en/guides/upgrade-to/v6.mdx b/src/content/docs/en/guides/upgrade-to/v6.mdx index 5fae4fa496dd3..d83544bb25aa9 100644 --- a/src/content/docs/en/guides/upgrade-to/v6.mdx +++ b/src/content/docs/en/guides/upgrade-to/v6.mdx @@ -10,4 +10,47 @@ import { Steps } from '@astrojs/starlight/components'; import ReadMore from '~/components/ReadMore.astro' import SourcePR from '~/components/SourcePR.astro' -This guide will help you migrate from Astro v5 to Astro v6. \ No newline at end of file +This guide will help you migrate from Astro v5 to Astro v6. + +--- +title: Upgrade to Astro v6 +description: How to upgrade your project to Astro v6.0. +sidebar: + label: v6.0 +i18nReady: true +--- +import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro' +import { Steps } from '@astrojs/starlight/components'; +import ReadMore from '~/components/ReadMore.astro' +import SourcePR from '~/components/SourcePR.astro' + +This guide will help you migrate from Astro v5 to Astro v6. + +## Removed + +### Removed: `` component + + + +Astro 5.0 renames component `` to `` to clarify the role of the component. The new name makes it more clear that the features you get from Astro's `` routing component are slightly different from the native CSS-based MPA router. No functionality has changed. This component has only changed its name. + +In Astro 6.0, the `` component has been removed. + +#### What should I do? + +Replace all occurrences of the `ViewTransitions` import and component with `ClientRouter`: + +```astro title="src/layouts/MyLayout.astro" del={1,7} ins={2,8} +import { ViewTransitions } from 'astro:transitions'; +import { ClientRouter } from 'astro:transitions'; + + + + ... + + + + +``` + +Read more about [view transitions and client-side routing in Astro](/en/guides/view-transitions/). From 077c5e9144ddcb0b62d628ad60334ae7bbd25af4 Mon Sep 17 00:00:00 2001 From: ellielok Date: Fri, 19 Sep 2025 19:31:18 +1000 Subject: [PATCH 2/5] Remove duplicated lines --- src/content/docs/en/guides/upgrade-to/v6.mdx | 14 -------------- 1 file changed, 14 deletions(-) diff --git a/src/content/docs/en/guides/upgrade-to/v6.mdx b/src/content/docs/en/guides/upgrade-to/v6.mdx index d83544bb25aa9..246f339dc3272 100644 --- a/src/content/docs/en/guides/upgrade-to/v6.mdx +++ b/src/content/docs/en/guides/upgrade-to/v6.mdx @@ -12,20 +12,6 @@ import SourcePR from '~/components/SourcePR.astro' This guide will help you migrate from Astro v5 to Astro v6. ---- -title: Upgrade to Astro v6 -description: How to upgrade your project to Astro v6.0. -sidebar: - label: v6.0 -i18nReady: true ---- -import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro' -import { Steps } from '@astrojs/starlight/components'; -import ReadMore from '~/components/ReadMore.astro' -import SourcePR from '~/components/SourcePR.astro' - -This guide will help you migrate from Astro v5 to Astro v6. - ## Removed ### Removed: `` component From 9baca0d6ebc04695e094781ae652067b2614e37c Mon Sep 17 00:00:00 2001 From: ellielok Date: Fri, 19 Sep 2025 19:50:34 +1000 Subject: [PATCH 3/5] Update coping --- src/content/docs/en/guides/upgrade-to/v6.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/content/docs/en/guides/upgrade-to/v6.mdx b/src/content/docs/en/guides/upgrade-to/v6.mdx index 11a35e70dc487..b8ce736a2cffc 100644 --- a/src/content/docs/en/guides/upgrade-to/v6.mdx +++ b/src/content/docs/en/guides/upgrade-to/v6.mdx @@ -79,9 +79,9 @@ Projects now containing these removed features will be unable to build, and ther -Astro 5.0 renames component `` to `` to clarify the role of the component. The new name makes it more clear that the features you get from Astro's `` routing component are slightly different from the native CSS-based MPA router. No functionality has changed. This component has only changed its name. +In Astro 5.0, the `` component was renamed to `` to clarify the role of the component. The new name makes it more clear that the features you get from Astro's `` routing component are slightly different from the native CSS-based MPA router. No functionality has changed. This component has only changed its name. Both components are available in Astro 5.x. -In Astro 6.0, the `` component has been removed. +Astro 6.0 removes the `` component, you need to use the `` component instead. #### What should I do? From 7c3f3222afe016e7a776865ab582bf1cd618b3bb Mon Sep 17 00:00:00 2001 From: Sarah Rainsberger <5098874+sarah11918@users.noreply.github.com> Date: Fri, 19 Sep 2025 08:38:48 -0300 Subject: [PATCH 4/5] update wording to focus more on deprecation/removal --- src/content/docs/en/guides/upgrade-to/v6.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/content/docs/en/guides/upgrade-to/v6.mdx b/src/content/docs/en/guides/upgrade-to/v6.mdx index b8ce736a2cffc..a6fc72126a888 100644 --- a/src/content/docs/en/guides/upgrade-to/v6.mdx +++ b/src/content/docs/en/guides/upgrade-to/v6.mdx @@ -79,9 +79,9 @@ Projects now containing these removed features will be unable to build, and ther -In Astro 5.0, the `` component was renamed to `` to clarify the role of the component. The new name makes it more clear that the features you get from Astro's `` routing component are slightly different from the native CSS-based MPA router. No functionality has changed. This component has only changed its name. Both components are available in Astro 5.x. +In Astro 5.0, the `` component was renamed to `` to clarify the role of the component. The new name makes it more clear that the features you get from Astro's `` routing component are slightly different from the native CSS-based MPA router. However, a deprecated version of the `` component still existed and may have functioned in Astro 5.x. -Astro 6.0 removes the `` component, you need to use the `` component instead. +Astro 6.0 removes the `` component entirely and can no longer be used in your project. Update to the `` component to continue to use these features. #### What should I do? From 47c9c99ceba9a39bb21873d1fe72014fa6eb3de4 Mon Sep 17 00:00:00 2001 From: Sarah Rainsberger <5098874+sarah11918@users.noreply.github.com> Date: Fri, 19 Sep 2025 09:15:55 -0300 Subject: [PATCH 5/5] fix changeset grammar --- src/content/docs/en/guides/upgrade-to/v6.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/en/guides/upgrade-to/v6.mdx b/src/content/docs/en/guides/upgrade-to/v6.mdx index a6fc72126a888..41552d4979312 100644 --- a/src/content/docs/en/guides/upgrade-to/v6.mdx +++ b/src/content/docs/en/guides/upgrade-to/v6.mdx @@ -81,7 +81,7 @@ Projects now containing these removed features will be unable to build, and ther In Astro 5.0, the `` component was renamed to `` to clarify the role of the component. The new name makes it more clear that the features you get from Astro's `` routing component are slightly different from the native CSS-based MPA router. However, a deprecated version of the `` component still existed and may have functioned in Astro 5.x. -Astro 6.0 removes the `` component entirely and can no longer be used in your project. Update to the `` component to continue to use these features. +Astro 6.0 removes the `` component entirely and it can no longer be used in your project. Update to the `` component to continue to use these features. #### What should I do?