diff --git a/docs/start/framework/solid/guide/hosting.md b/docs/start/framework/solid/guide/hosting.md index d737c4695c0..e6a3b002011 100644 --- a/docs/start/framework/solid/guide/hosting.md +++ b/docs/start/framework/solid/guide/hosting.md @@ -187,54 +187,19 @@ tool](https://docs.netlify.com/start/quickstarts/deploy-from-ai-code-generation- ### Nitro -[Nitro](https://nitro.build/) is an abstraction layer that allows you to deploy TanStack Start applications to [a wide range of providers](https://nitro.build/deploy). +[Nitro](https://v3.nitro.build/) is an agnostic layer that allows you to deploy TanStack Start applications to [a wide range of hostings](https://v3.nitro.build/deploy). -**⚠️ During TanStack Start 1.0 release candidate phase, we currently recommend using:** - -- [@tanstack/nitro-v2-vite-plugin (Temporary Compatibility Plugin)](https://www.npmjs.com/package/@tanstack/nitro-v2-vite-plugin) - A temporary compatibility plugin for using Nitro v2 as the underlying build tool for TanStack Start. -- [Nitro v3's Vite Plugin (ALPHA)](https://www.npmjs.com/package/nitro) - An **ALPHA** plugin for officially using Nitro v3 as the underlying build tool for TanStack Start. - -#### Using Nitro v2 - -**⚠️ `@tanstack/nitro-v2-vite-plugin` is a temporary compatibility plugin for using Nitro v2 as the underlying build tool for TanStack Start. Use this plugin if you experience issues with the Nitro v3 plugin. It does not support all of Nitro v3's features and is limited in its dev server capabilities, but should work as a safe fallback, even for production deployments for those who were using TanStack Start's alpha/beta versions.** - -```tsx -import { tanstackStart } from '@tanstack/solid-start/plugin/vite' -import { defineConfig } from 'vite' -import viteSolid from 'vite-plugin-solid' -import { nitroV2Plugin } from '@tanstack/nitro-v2-vite-plugin' - -export default defineConfig({ - plugins: [ - tanstackStart(), - nitroV2Plugin(/* - // nitro config goes here, e.g. - { preset: 'node-server' } - */), - viteSolid({ ssr: true }), - ], -}) -``` - -#### Using Nitro v3 (ALPHA) - -**⚠️ The [`nitro`](https://www.npmjs.com/package/nitro) vite plugin is an official **ALPHA** plugin from the Nitro team for using Nitro v3 as the underlying build tool for TanStack Start. It is still in development and is receiving regular updates.** +**⚠️ The [`nitro/vite`](https://v3.nitro.build/) plugin natively integrates with Vite Environments API as the underlying build tool for TanStack Start. It is still under active development and receives regular updates. Please report any issues you encounter with reproduction so they can be investigated.** ```tsx import { tanstackStart } from '@tanstack/solid-start/plugin/vite' import { defineConfig } from 'vite' -import viteSolid from 'vite-plugin-solid' import { nitro } from 'nitro/vite' +import viteSolid from 'vite-plugin-solid' export default defineConfig({ - plugins: [ - tanstackStart(), - nitro(/* - // nitro config goes here, e.g. - { config: { preset: 'node-server' } } - */) - viteSolid({ssr: true}), - ], + plugins: [tanstackStart(), nitro(), viteSolid({ ssr: true })], + nitro: {}, }) ``` @@ -276,15 +241,13 @@ Depending on how you invoke the build, you might need to set the `'bun'` preset import { tanstackStart } from '@tanstack/solid-start/plugin/vite' import { defineConfig } from 'vite' import viteSolid from 'vite-plugin-solid' -import { nitroV2Plugin } from '@tanstack/nitro-v2-vite-plugin' -// alternatively: import { nitro } from 'nitro/vite' +import { nitro } from 'nitro/vite' export default defineConfig({ plugins: [ tanstackStart(), - nitroV2Plugin({ preset: 'bun' }) - // alternatively: nitro( { config: { preset: 'bun' }} ), - viteSolid({ssr: true}), + nitro({ preset: 'bun' }) + viteSolid({ssr: true}), ], }) ```