migrate-to-vinext

SKILL.md

Migrate Next.js to vinext

vinext reimplements the Next.js API surface on Vite. Existing app/, pages/, and next.config.js work as-is — migration is a package swap, config generation, and ESM conversion. No changes to application code required.

FIRST: Verify Next.js Project

Confirm next is in dependencies or devDependencies in package.json. If not found, STOP — this skill does not apply.

Detect the package manager from the lockfile:

Lockfile
Manager
Install
Uninstall

pnpm-lock.yaml
pnpm
pnpm add
pnpm remove

yarn.lock
yarn
yarn add
yarn remove

bun.lockb / bun.lock
bun
bun add
bun remove

package-lock.json or none
npm
npm install
npm uninstall

Detect the router: if an app/ directory exists at root or under src/, it's App Router. If only pages/ exists, it's Pages Router. Both can coexist.