From b27217e43f5bfc9fc6250123025ca8c886ccc1d1 Mon Sep 17 00:00:00 2001 From: Birk Skyum Date: Thu, 16 Jul 2026 03:42:04 +0200 Subject: [PATCH 1/6] deprecation note in nitro v2 plugin --- packages/start-nitro-v2-vite-plugin/README.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/packages/start-nitro-v2-vite-plugin/README.md b/packages/start-nitro-v2-vite-plugin/README.md index 2f690e318..97dcd8b17 100644 --- a/packages/start-nitro-v2-vite-plugin/README.md +++ b/packages/start-nitro-v2-vite-plugin/README.md @@ -1,5 +1,20 @@ # Vite-Plugin-Nitro-2 +> [!WARNING] +> This Nitro v2 plugin is deprecated. For new projects, use Nitro v3 and its official Vite plugin instead: +> +> ```ts +> import { solidStart } from "@solidjs/start/config"; +> import { nitro } from "nitro/vite"; +> import { defineConfig } from "vite"; +> +> export default defineConfig({ +> plugins: [solidStart(), nitro({ preset: "node-server" })] +> }); +> ``` +> +> See the official [SolidStart templates](https://github.com/solidjs/templates/tree/main/solid-start-v2) for complete, up-to-date examples. + This package moves Nitro into a Vite-Plugin to consolidate the API surface between Nitro v2 and v3. ## Usage From ee62e3bbbb985fe3aaa116487ae3f993e32a8b17 Mon Sep 17 00:00:00 2001 From: Birk Skyum Date: Thu, 16 Jul 2026 03:42:53 +0200 Subject: [PATCH 2/6] add changeset --- .changeset/fair-bars-fail.md | 5 +++++ 1 file changed, 5 insertions(+) create mode 100644 .changeset/fair-bars-fail.md diff --git a/.changeset/fair-bars-fail.md b/.changeset/fair-bars-fail.md new file mode 100644 index 000000000..cdf6ef7a1 --- /dev/null +++ b/.changeset/fair-bars-fail.md @@ -0,0 +1,5 @@ +--- +"@solidjs/vite-plugin-nitro-2": patch +--- + +fix: add deprecation note From 595e71372e817d46e5d03f526ee613107d7af52e Mon Sep 17 00:00:00 2001 From: Birk Skyum Date: Thu, 16 Jul 2026 04:09:19 +0200 Subject: [PATCH 3/6] buildtime warning --- .changeset/tidy-cats-smile.md | 5 +++++ packages/start-nitro-v2-vite-plugin/src/index.ts | 7 +++++++ 2 files changed, 12 insertions(+) create mode 100644 .changeset/tidy-cats-smile.md diff --git a/.changeset/tidy-cats-smile.md b/.changeset/tidy-cats-smile.md new file mode 100644 index 000000000..a53650a53 --- /dev/null +++ b/.changeset/tidy-cats-smile.md @@ -0,0 +1,5 @@ +--- +"@solidjs/vite-plugin-nitro-2": patch +--- + +Warn at build time that the Nitro v2 plugin is deprecated and guide users to Nitro v3. diff --git a/packages/start-nitro-v2-vite-plugin/src/index.ts b/packages/start-nitro-v2-vite-plugin/src/index.ts index 7db44d76b..328553f74 100644 --- a/packages/start-nitro-v2-vite-plugin/src/index.ts +++ b/packages/start-nitro-v2-vite-plugin/src/index.ts @@ -20,6 +20,13 @@ export function nitroV2Plugin(nitroConfig?: UserNitroConfig): PluginOption { return [ { name: "solid-start-vite-plugin-nitro", + configResolved(config) { + if (config.command === "build") { + config.logger.warn( + "[@solidjs/vite-plugin-nitro-2] This plugin is deprecated. Migrate to Nitro v3 using the official `nitro/vite` plugin. See https://github.com/solidjs/templates/tree/main/solid-start-v2 for examples.", + ); + } + }, generateBundle: { handler(_options, bundle) { if (this.environment.name !== "ssr") { From 80d73d66dffb46737f6a3b101eb82e2a8cad3056 Mon Sep 17 00:00:00 2001 From: Birk Skyum Date: Thu, 16 Jul 2026 04:12:46 +0200 Subject: [PATCH 4/6] improve changeste --- .changeset/fair-bars-fail.md | 2 +- .changeset/tidy-cats-smile.md | 5 ----- 2 files changed, 1 insertion(+), 6 deletions(-) delete mode 100644 .changeset/tidy-cats-smile.md diff --git a/.changeset/fair-bars-fail.md b/.changeset/fair-bars-fail.md index cdf6ef7a1..f40384248 100644 --- a/.changeset/fair-bars-fail.md +++ b/.changeset/fair-bars-fail.md @@ -2,4 +2,4 @@ "@solidjs/vite-plugin-nitro-2": patch --- -fix: add deprecation note +fix: add deprecation note and warn at build time that the Nitro v2 plugin is deprecated and guide users to Nitro v3. diff --git a/.changeset/tidy-cats-smile.md b/.changeset/tidy-cats-smile.md deleted file mode 100644 index a53650a53..000000000 --- a/.changeset/tidy-cats-smile.md +++ /dev/null @@ -1,5 +0,0 @@ ---- -"@solidjs/vite-plugin-nitro-2": patch ---- - -Warn at build time that the Nitro v2 plugin is deprecated and guide users to Nitro v3. From 3906acc8f96a471706e20213bb6a3ca86408fc59 Mon Sep 17 00:00:00 2001 From: Birk Skyum Date: Thu, 16 Jul 2026 04:13:24 +0200 Subject: [PATCH 5/6] warn in cli --- packages/start-nitro-v2-vite-plugin/src/index.ts | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/packages/start-nitro-v2-vite-plugin/src/index.ts b/packages/start-nitro-v2-vite-plugin/src/index.ts index 328553f74..7961e5c5e 100644 --- a/packages/start-nitro-v2-vite-plugin/src/index.ts +++ b/packages/start-nitro-v2-vite-plugin/src/index.ts @@ -17,11 +17,14 @@ let ssrEntryFile: string; export type UserNitroConfig = Omit; export function nitroV2Plugin(nitroConfig?: UserNitroConfig): PluginOption { + let didWarn = false; + return [ { name: "solid-start-vite-plugin-nitro", configResolved(config) { - if (config.command === "build") { + if (config.command === "build" && !didWarn) { + didWarn = true; config.logger.warn( "[@solidjs/vite-plugin-nitro-2] This plugin is deprecated. Migrate to Nitro v3 using the official `nitro/vite` plugin. See https://github.com/solidjs/templates/tree/main/solid-start-v2 for examples.", ); From 5a6501d165c1215e9498fa4c5f7549bbc49723f6 Mon Sep 17 00:00:00 2001 From: Birk Skyum Date: Thu, 16 Jul 2026 04:18:40 +0200 Subject: [PATCH 6/6] point to both templates and nitror docs --- packages/start-nitro-v2-vite-plugin/README.md | 2 +- packages/start-nitro-v2-vite-plugin/src/index.ts | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/packages/start-nitro-v2-vite-plugin/README.md b/packages/start-nitro-v2-vite-plugin/README.md index 97dcd8b17..968cdb3a4 100644 --- a/packages/start-nitro-v2-vite-plugin/README.md +++ b/packages/start-nitro-v2-vite-plugin/README.md @@ -13,7 +13,7 @@ > }); > ``` > -> See the official [SolidStart templates](https://github.com/solidjs/templates/tree/main/solid-start-v2) for complete, up-to-date examples. +> See the official [SolidStart Vite configuration](https://github.com/solidjs/templates/blob/main/solid-start-v2/bare/vite.config.ts) for an up-to-date example and the [Nitro Vite integration guide](https://nitro.build/docs#vite-integration) for general configuration. This package moves Nitro into a Vite-Plugin to consolidate the API surface between Nitro v2 and v3. diff --git a/packages/start-nitro-v2-vite-plugin/src/index.ts b/packages/start-nitro-v2-vite-plugin/src/index.ts index 7961e5c5e..54d4712ba 100644 --- a/packages/start-nitro-v2-vite-plugin/src/index.ts +++ b/packages/start-nitro-v2-vite-plugin/src/index.ts @@ -26,7 +26,7 @@ export function nitroV2Plugin(nitroConfig?: UserNitroConfig): PluginOption { if (config.command === "build" && !didWarn) { didWarn = true; config.logger.warn( - "[@solidjs/vite-plugin-nitro-2] This plugin is deprecated. Migrate to Nitro v3 using the official `nitro/vite` plugin. See https://github.com/solidjs/templates/tree/main/solid-start-v2 for examples.", + "[@solidjs/vite-plugin-nitro-2] This plugin is deprecated. Migrate to Nitro v3 using the official `nitro/vite` plugin. See https://github.com/solidjs/templates/blob/main/solid-start-v2/bare/vite.config.ts for a SolidStart example and https://nitro.build/docs#vite-integration for general configuration.", ); } },