Upgrade to Astro 6

👋 Intro

~~BrainByteZ has been upgraded to Astro 6. 🚀~~

The upgrade process went almost flawless, one vite build warning and one astro dev error needs to be resolved.

Update: I decided to rollback to Astro 5.18.1 until the astro dev error is fixed.

1️⃣ Step 1: Run -> `bunx @astrojs/upgrade`

astro   Integration upgrade in progress.

        @astrojs/check is up to date on v0.9.8
        @astrojs/rss is up to date on v4.0.17
        @astrojs/sitemap is up to date on v3.7.1
        astro will be updated  from v5.18.1 to v6.0.7
        @astrojs/mdx will be updated  from v4.3.14 to v5.0.2

wait    Some packages have breaking changes. Continue?
        Yes

check   Be sure to follow the CHANGELOGs.
        astro Upgrade to Astro v6
        @astrojs/mdx CHANGELOG

        Installing dependencies with bun...

Houston:
Can't wait to see what you build.

2️⃣ Step 2: Run -> `bunx zod-v3-to-v4`

  Let's migrate Zod from v3 to v4

  Where is your tsconfig.json?
  tsconfig.json

  All files have been migrated.

  You're all set!

This changed the zod import statement as described in the Astro 6 upgrade docs .

import { z } from "astro/zod";

The following vite build warning is shown during bun run build and still needs to be resolved.

⚠️

[WARN] [vite] “matchHostname”, “matchPathname”, “matchPort” and “matchProtocol” are imported from external module “@astrojs/internal-helpers/remote” but never used in “node_modules/astro/dist/assets/utils/index.js”.

See GitHub issue: 15957

Astro: v6.0.7
Node: v24.13.0
System: Windows (x64)
Package Manager: bun
Output: static
Adapter: none

Luckily, the warning is purely cosmetic according to Claude 🤖

ℹ️

The warning is purely cosmetic — it does not affect your build output, runtime behavior, or performance. You can safely ignore it while it exists. It won’t cause errors or broken functionality. The build will still complete successfully as shown in the GitHub issue reports.

Update: I discovered that there is also an error when running astro dev with bun run dev after visiting the web-server in the browser.

🚨

[ERROR] [vite] Internal server error: Failed to resolve import “@vite/env” from “node_modules/astro/node_modules/vite/dist/client/client.mjs”. Does the file exist?

[ERROR] [vite] Internal server error: Failed to resolve import "@vite/env" from "node_modules/astro/node_modules/vite/dist/client/client.mjs". Does the file exist?
  Plugin: vite:import-analysis
  File: node_modules/astro/node_modules/vite/dist/client/client.mjs:1:8
  1  |  import "@vite/env";
     |          ^

For now I decided to rollback to Astro 5.18.1 until the astro dev error is fixed.

Buy Me a Coffee

Ko-fi

Threema icon - Tabler Icons (Unofficial)

Comments 💬

👋 Intro

1️⃣ Step 1: Run -> bunx @astrojs/upgrade

2️⃣ Step 2: Run -> bunx zod-v3-to-v4

1️⃣ Step 1: Run -> `bunx @astrojs/upgrade`

2️⃣ Step 2: Run -> `bunx zod-v3-to-v4`