Migrating from v1

This guide covers the package-level migration changes for SolidStart 2.0. It focuses on the parts of the upgrade that already have corresponding v2 docs in this site.

Some ecosystem packages may still target v1-only APIs. Audit those dependencies before shipping a production upgrade.

Migration steps

Update dependencies

npm i @solidjs/[email protected]

pnpm i @solidjs/[email protected]

yarn add @solidjs/[email protected]

bun i @solidjs/[email protected]

deno add npm:@solidjs/[email protected]

npm remove vinxi

pnpm remove vinxi

yarn remove vinxi

bun remove vinxi

deno remove npm:vinxi

The framework plugin now comes from @solidjs/start/config.

Move framework configuration into vite.config.ts

V1 projects centered their framework configuration around app.config.ts. Move that setup into a Vite config that calls solidStart().

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

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

If your app already has custom middleware, solidStart() also exposes a middleware option:

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

export default defineConfig({
  plugins: [solidStart({ middleware: "./src/middleware/index.ts" })],
});

Update server runtime imports

HTTP helpers are exported from @solidjs/start/http. Replace imports from vinxi/http with that module.

import { getCookie, setCookie, useSession } from "@solidjs/start/http";

The HTTP entrypoint exposes helpers such as readBody, getQuery, getRequestHeader, setResponseHeader, useSession, and related cookie/session utilities.

Update TypeScript environment types

Environment types ship in @solidjs/start/env. Make sure your TypeScript config includes it.

{
  "compilerOptions": {
    "types": ["@solidjs/start/env"]
  }
}

Revisit middleware syntax

The v2 middleware entrypoint exports createMiddleware, and its types now prefer H3 middleware arrays. The older onRequest and onBeforeResponse object form is still present but marked deprecated in the package types.

import { createMiddleware } from "@solidjs/start/middleware";

export default createMiddleware([
  async (_event, next) => {
    return await next();
  },
]);

Still in the v1 docs

A few topics keep their v1 guidance until the v2 pages land:

• Entrypoint file replacements
• Production start script names for generated apps
• Auth, prerendering, metadata, and background tasks