Deployment plugins

SolidStart v2 uses Vite's Environment API for its client and server builds. The solidStart() plugin configures the application, while a deployment Vite plugin integrates the server build with a production runtime and hosting target.

Choose one deployment plugin. Nitro provides portable deployment presets, while the Netlify and Cloudflare plugins integrate directly with their respective platforms.

Nitro

Nitro v3 supports multiple deployment targets through presets.

npm i nitro

pnpm i nitro

yarn add nitro

bun i nitro

deno add npm:nitro

Add nitro() after solidStart():

import { nitro } from "nitro/vite";
import { defineConfig } from "vite";
import { solidStart } from "@solidjs/start/config";

export default defineConfig({
  plugins: [solidStart(), nitro()],
});

Use the top-level nitro property for deployment presets, prerendering, tasks, WebSockets, and other Nitro options. See the Nitro configuration reference.

Netlify

The Netlify Vite plugin prepares the server build for Netlify Functions and emulates Netlify platform features during development.

npm i @netlify/vite-plugin -D

pnpm i @netlify/vite-plugin -D

yarn add @netlify/vite-plugin -D

bun i @netlify/vite-plugin -d

deno add npm:@netlify/vite-plugin -D

Add the plugin after solidStart() and enable its build support:

import netlify from "@netlify/vite-plugin";
import { defineConfig } from "vite";
import { solidStart } from "@solidjs/start/config";

export default defineConfig({
  plugins: [solidStart(), netlify({ build: { enabled: true } })],
});

No SolidStart-specific adapter is required. Netlify detects SolidStart and can supply the build command and publish directory automatically. Its SolidStart v2 announcement explains how the integration uses Vite's Environment API.

Cloudflare

The Cloudflare Vite plugin runs the server build in the Workers runtime during development and prepares it for deployment to Cloudflare.

npm i @cloudflare/vite-plugin wrangler -D

pnpm i @cloudflare/vite-plugin wrangler -D

yarn add @cloudflare/vite-plugin wrangler -D

bun i @cloudflare/vite-plugin wrangler -d

deno add npm:@cloudflare/vite-plugin wrangler -D

Map the Worker to SolidStart's ssr environment:

import { cloudflare } from "@cloudflare/vite-plugin";
import { defineConfig } from "vite";
import { solidStart } from "@solidjs/start/config";

export default defineConfig({
  plugins: [cloudflare({ viteEnvironment: { name: "ssr" } }), solidStart()],
});

The viteEnvironment option merges the Workers runtime configuration with SolidStart's server environment. Follow the Cloudflare guide to add a Wrangler configuration and any platform bindings.