# migrate-to-vinext

> Claude/Codex skill by [@cloudflare](https://omgskills.com/library/cloudflare/index.md) · 8.8k stars · Updated 2026-09-11

Migrates Next.js projects to vinext (Vite-based Next.js reimplementation). Load when asked to migrate, convert, or switch from Next.js to vinext. Handles compatibility scanning, package replacement, Vite config generation, ESM conversion, and deployment setup (Cloudflare Workers natively, other platforms via Nitro).

## Install

```sh
git clone https://github.com/cloudflare/vinext /tmp/vinext && ln -s /tmp/vinext/.agents/skills/migrate-to-vinext ~/.claude/skills/migrate-to-vinext
```

## From README

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 | | 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 | 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.

## Links

- HTML page: https://omgskills.com/skills/cloudflare/vinext/migrate-to-vinext/
- GitHub: https://github.com/cloudflare/vinext
- Author: [@cloudflare](https://omgskills.com/library/cloudflare/index.md)

## More skills by this author

- [cloudflare-browser](https://omgskills.com/skills/cloudflare/moltworker/cloudflare-browser/index.md) — Control headless Chrome via Cloudflare Browser Rendering CDP WebSocket.
   - [@cloudflare](https://omgskills.com/library/cloudflare/index.md) · 10k stars
- [capnweb](https://omgskills.com/skills/cloudflare/computer/dot-agents/skills/capnweb/index.md) — capnweb RPC patterns for this repo, with a heavy focus on stub lifecycle and disposal.
   - [@cloudflare](https://omgskills.com/library/cloudflare/index.md) · 9.2k stars
- [bazel-test-hygiene](https://omgskills.com/skills/cloudflare/workerd/bazel-test-hygiene/index.md) — Mandatory rules for running bazel tests during development.
   - [@cloudflare](https://omgskills.com/library/cloudflare/index.md) · 8.7k stars