1.0

Qwik + Astro 1.0

Qwik + Astro 1.0 brings the project onto the new @qwik.dev/* package scope and updates the integration for Qwik v2, Astro 6, and Vite 7.

This is the biggest update to the project so far, with a new upgrade path for existing users, a more capable CLI, improved client-router support, and stronger platform coverage.

What Changed

• @qwikdev/astro has moved to @qwik.dev/astro
• create-qwikdev-astro has moved to @qwik.dev/create-astro
• Qwik + Astro now targets Qwik v2 and Astro 6
• The CLI better supports both add and a new upgrade flow
• The docs now include a dedicated upgrade guide for migrating from v1

Breaking Changes

• Astro 6+ is now required
• Qwik v2 is now required
• The package scope changed from @qwikdev/* to @qwik.dev/*
• If you use Astro’s <ClientRouter />, you now need to configure clientRouter in the Qwik integration options

@qwik.dev/astro 1.0

Highlights:

• Updated for Qwik v2, Astro 6, and Vite 7
• Better ClientRouter support for SPA-style navigation
• Improved useVisibleTask$ behavior under Astro navigation
• Automatic Qwik entrypoint scanning
• Server rendering improvements, including cleaner slot handling
• Platform test coverage for Node, Netlify, and Vercel

@qwik.dev/create-astro 1.0

API Surface Highlights:

• New add command for existing Astro projects
• New upgrade command for migrating from v1
• Better detection of existing Astro config and JSX framework setup
• Automatic config rewriting for supported add/upgrade cases
• Starter Qwik component scaffolding for existing-project installs
• Six built-in starter templates across runtime and formatter options
• Support for Astro templates via Astro’s template flow
• Cross-platform CLI testing on Linux, macOS, and Windows

Quick Start

Create a new project:

npm create @qwik.dev/astro@latest

Upgrade an existing v1 project:

npm create @qwik.dev/astro@latest upgrade

Upgrade Guide

If you’re coming from v1, start here:

https://astro.qwik.dev/docs/upgrade/