Compatibility Matrix
Real, current package versions and Node.js/runtime requirements — re-derived directly from every package.json in the monorepo.
This table was generated by reading every workspace manifest in the repository directly — not
copied from an earlier phase's registry — so it reflects the actual current state.
NextRush intentionally runs a mixed-version monorepo: the fixed core group releases at
4.0.2, while packages added later version independently on their own 0.x–3.x semver lines.
A 1.0.1 package is not less mature than a 4.0.2 one — it started its own semver line later.
See Versioning for the policy.
Runtime requirement
All packages require Node.js >=22.0.0 (from the repository root package.json's
engines field). Bun, Deno, and Edge targets are supported via dedicated adapter packages —
they do not lower the underlying Node.js baseline used for tooling/build.
Fixed core group (4.0.2)
These packages are configured as one fixed group and always release together.
| Package | Version | Type |
|---|---|---|
nextrush | 4.0.2 | Meta package |
@nextrush/types | 4.0.2 | Core |
@nextrush/errors | 4.0.2 | Core |
@nextrush/core | 4.0.2 | Core |
@nextrush/router | 4.0.2 | Core |
@nextrush/runtime | 4.0.2 | Core |
@nextrush/di | 4.0.2 | Core |
@nextrush/adapter-node | 4.0.2 | Adapter |
Independently-versioned packages
Each of these versions independently — a patch to one does not bump any other package.
| Package | Version | Type |
|---|---|---|
@nextrush/adapter-bun | 1.0.1 | Adapter |
@nextrush/adapter-deno | 1.0.1 | Adapter |
@nextrush/adapter-edge | 1.0.1 | Adapter |
@nextrush/adapter-nextjs | 1.0.1 | Adapter |
@nextrush/adapter-serverless | 1.0.1 | Adapter |
@nextrush/body-parser | 4.0.1 | Middleware |
@nextrush/class | 1.0.2 | Class runtime |
@nextrush/compression | 3.0.7 | Middleware |
@nextrush/cookies | 1.0.1 | Middleware |
@nextrush/cors | 4.0.1 | Middleware |
@nextrush/csrf | 1.0.1 | Middleware |
@nextrush/dev | 1.1.3 | Tooling |
@nextrush/events | 1.0.1 | Extension |
@nextrush/express-bridge | 0.1.1 | Interop |
@nextrush/form-data | 1.0.1 | Middleware |
@nextrush/health | 1.0.1 | Middleware |
@nextrush/helmet | 4.0.1 | Middleware |
@nextrush/logger | 2.0.0 | Middleware |
@nextrush/openapi | 1.0.3 | Middleware |
@nextrush/rate-limit | 1.0.1 | Middleware |
@nextrush/request-id | 1.0.1 | Middleware |
@nextrush/security | 1.0.1 | Middleware |
@nextrush/static | 1.0.1 | Middleware |
@nextrush/stream | 1.0.2 | Extension |
@nextrush/template | 1.0.1 | Middleware |
@nextrush/testing | 1.0.2 | Tooling |
@nextrush/timer | 1.0.1 | Middleware |
@nextrush/validation | 1.0.2 | Middleware |
@nextrush/websocket | 1.0.1 | Extension |
create-nextrush | 1.3.1 | Scaffolder |
Total: 38 public packages. The monorepo has 52 workspace projects; the other 14 are private
(including @nextrush/adapter-conformance, deployment-verification fixtures, and Next.js test
apps) and are not published to npm.
Runtime support matrix
| Runtime | Adapter package | Adapter version | Status | Proof |
|---|---|---|---|---|
| Node.js 22+ | @nextrush/adapter-node | 4.0.2 | Stable | 🟢 real-runtime (native) |
| Bun | @nextrush/adapter-bun | 1.0.1 | Stable | 🟢 real-runtime (CI, real Bun) |
| Deno | @nextrush/adapter-deno | 1.0.1 | Stable | 🟢 real-runtime (CI, real Deno) |
| Cloudflare Workers | @nextrush/adapter-edge | 1.0.1 | Beta (Internal tier) | 🟢 real-runtime (CI, real workerd/miniflare) |
| Vercel Edge | @nextrush/adapter-edge | 1.0.1 | Beta (Internal tier) | 🟡 simulated (shares the edge adapter's conformance suite; not yet executed on the real platform in CI) |
| Netlify Edge | @nextrush/adapter-edge | 1.0.1 | Beta (Internal tier) | 🟡 simulated (runs on Deno under the hood; not yet executed on the real platform in CI) |
| AWS Lambda / GCF / Azure Functions | @nextrush/adapter-serverless | 1.0.1 | Beta (Internal tier) | 🟡 simulated (built on @nextrush/adapter-edge's fetch engine; not yet executed on a real serverless platform in CI) |
What 🟢/🟡 means
🟢 real-runtime — the conformance suite executes on the actual runtime in CI (a real Bun/
Deno process, or a real Cloudflare workerd/miniflare isolate), not simulated under Node. 🟡
simulated — the adapter is implemented and passes the shared conformance suite, but that
suite currently runs in-process under Node/vitest for this target, not on the real platform.
See docs/audits/08-runtime-compatibility-gap-analysis.md for the full breakdown and the
work tracked to close the remaining 🟡 rows.
Known, unresolved conflict with ADR-0005
This table classifies every non-Node adapter as Stable, based on adapter version and
conformance-suite results. ADR-0005
classifies runtime and every non--node adapter as Internal — may change without a major
bump, until GA, a stricter tier than "Stable" implies. This is a real, unresolved
disagreement between two source-of-truth documents, first identified during Wave B1 of the
v4 documentation rebuild — it is deliberately left logged here rather than silently resolved
in either direction pending a maintainer decision. Readers relying on this page for a
stability guarantee on Bun, Deno, Edge, or Serverless should also read ADR-0005's tier table
before treating "Stable" as a semver commitment.
How to check this yourself
Version drift between this page and reality is a documentation bug. Re-derive the table with:
pnpm list -r --depth -1 --json | node -e "
let s = '';
process.stdin.on('data', (d) => (s += d)).on('end', () => {
for (const p of JSON.parse(s)) if (!p.private) console.log(p.name + '\t' + p.version);
});
"If your output differs from the table above, the table is stale — please open an issue.
See also
- Changelog — what changed in each release.
- Package Hierarchy — the dependency chain between packages.
- Packages directory — browse all 38 packages with descriptions and category filters.