Documentation
Differences from Next.js
The compatibility boundaries to understand before adopting vinext.
vinext targets the stable Next.js 16 API surface, not undocumented Vercel behavior or every experimental feature. Run
vinext checkagainst your own application before adopting it.
Toolchain
Development, bundling, and production builds run on Vite 8 instead of the Next.js compiler toolchain. Vite plugins can extend the build, while webpack plugins and framework-specific build internals do not carry over automatically.
Deployment
Cloudflare Workers is the primary native target. Standalone Node output and Nitro adapters cover other hosts. Next.js route config values such as runtime and preferredRegion are currently ignored because runtime placement belongs to the selected deployment adapter.
Compatibility
App Router, Pages Router, RSC, Server Actions, middleware, Route Handlers, static generation, ISR, and the commonly used next/* modules are implemented. Cache Components and Partial Prerendering remain incomplete, and build-time image and font optimization do not yet reproduce the full Next.js pipeline.
How to read the docs
If a feature is not listed as a vinext difference, start with the corresponding Next.js documentation. For adoption decisions, the compatibility dashboard is the live view of test coverage, and the issue tracker records known gaps and focused reproductions.