Documentation

Migrate a Next.js app

Add vinext alongside an existing Next.js setup without rewriting the application.

Migration is non-destructive. vinext init leaves your Next.js scripts and source files in place, then adds parallel *:vinext scripts for evaluation.

1. Check compatibility

pnpm dlx vinext check

The scanner reports known unsupported configuration, imports, and project patterns. Also check the compatibility dashboard and open issues for behavior specific to your application.

2. Initialize vinext

pnpm dlx vinext init

Choose Cloudflare or Node when prompted. The command installs the required packages, adds ESM and Vite configuration, and creates deployment config for the selected platform.

For a non-interactive run, select the target explicitly:

pnpm dlx vinext init --platform=cloudflare
pnpm dlx vinext init --platform=node

3. Run both toolchains

pnpm dev:vinext
pnpm build:vinext
pnpm dev

Compare the routes and workflows your application depends on. Start with authentication, middleware, mutations, caching, and deployment bindings rather than only checking the home page.