fix: handle deprecated @astrojs/tailwind integration and update versi…

packages/upgrade/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @astrojs/upgrade
 
+## 0.6.3
+
+### Patch Changes
+
+- Fixed issue where upgrading projects with `@astrojs/tailwind` using `bunx @astrojs/upgrade` would fail with "migration tool can only be run on v3 project" error. The upgrade tool now properly handles the deprecated `@astrojs/tailwind` integration by showing a deprecation warning and guiding users to migrate to `@tailwindcss/vite` instead of attempting to upgrade to the deprecated v6.0.0.
+
 ## 0.6.2
 
 ### Patch Changes

packages/upgrade/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astrojs/upgrade",
-  "version": "0.6.2",
+  "version": "0.6.3",
   "type": "module",
   "author": "withastro",
   "license": "MIT",

packages/upgrade/src/actions/install.ts

@@ -32,6 +32,15 @@ export async function install(
 ) {
 	await banner();
 	newline();
+
+	// Special handling for deprecated @astrojs/tailwind
+	const tailwindPackage = ctx.packages.find(pkg => pkg.name === '@astrojs/tailwind');
+	if (tailwindPackage) {
+		await warn('deprecated', `@astrojs/tailwind is deprecated in favor of @tailwindcss/vite`);
+		await info('migrate', 'Please follow the migration guide: https://tailwindcss.com/docs/installation/framework-guides/astro');
+		newline();
+	}
+
 	const { current, dependencies, devDependencies } = filterPackages(ctx);
 	const toInstall = [...dependencies, ...devDependencies].sort(sortPackages);
 	for (const packageInfo of current.sort(sortPackages)) {
@@ -90,7 +99,13 @@ function filterPackages(ctx: Pick<Context, 'packages'>) {
 	const dependencies: PackageInfo[] = [];
 	const devDependencies: PackageInfo[] = [];
 	for (const packageInfo of ctx.packages) {
-		const { currentVersion, targetVersion, isDevDependency } = packageInfo;
+		const { currentVersion, targetVersion, isDevDependency, name } = packageInfo;
+
+		// Skip @astrojs/tailwind as it's deprecated and should not be upgraded
+		if (name === '@astrojs/tailwind') {
+			continue;
+		}
+
 		// Remove prefix from version before comparing
 		if (currentVersion.replace(/^\D+/, '') === targetVersion.replace(/^\D+/, '')) {
 			current.push(packageInfo);

packages/upgrade/src/actions/verify.ts

@@ -136,6 +136,16 @@ async function verifyVersions(
 }
 
 async function resolveTargetVersion(packageInfo: PackageInfo, registry: string): Promise<void> {
+	// Special handling for deprecated @astrojs/tailwind integration
+	// to prevent upgrade to v6.0.0 which is deprecated in favor of @tailwindcss/vite
+	if (packageInfo.name === '@astrojs/tailwind') {
+		packageInfo.isMajor = true;
+		packageInfo.changelogURL = 'https://tailwindcss.com/docs/installation/framework-guides/astro';
+		packageInfo.changelogTitle = 'Migrate to @tailwindcss/vite plugin';
+		// Don't upgrade @astrojs/tailwind, user should migrate to @tailwindcss/vite
+		return;
+	}
+
 	const packageMetadata = await fetch(`${registry}/${packageInfo.name}`, {
 		headers: { accept: 'application/vnd.npm.install-v1+json' },
 	});