Compatibility & Supported Versions
This page lists the framework and runtime versions each @comvi/* package officially supports. The ranges below are the peerDependencies declared in the published packages — pinning to versions outside these ranges is unsupported.
All @comvi/* packages share a single release cadence and are versioned in lockstep — install matching versions across the set. This page is verified against the 0.3 line.
As of 0.3.0 the packages are ESM-only — they ship a single ES-module build (no CommonJS / require() entry). Consume them via import or any modern bundler (Vite, webpack 5, esbuild, Rollup, Rspack, Next, etc.). The CDN UMD build (@comvi/core on unpkg/jsDelivr) is unaffected.
Framework bindings
Section titled “Framework bindings”| Package | Peer dependency | Supported range |
|---|---|---|
@comvi/vue | vue | ^3.0.0 |
@comvi/react | react | ^18.0.0 || ^19.0.0 |
@comvi/next | next | ^14.0.0 || ^15.0.0 |
@comvi/next | react | ^18.0.0 || ^19.0.0 |
@comvi/nuxt | nuxt | ^3.0.0 || ^4.0.0 |
@comvi/solid | solid-js | ^1.8.0 |
@comvi/svelte | svelte | ^5.0.0 |
@comvi/react requires React 18+ — it uses the native useSyncExternalStore; the React 16/17 use-sync-external-store shim was dropped in 0.3.0. @comvi/next requires App Router (Next 14+) and a React version that supports Server Components. @comvi/svelte is Svelte 5-only as of 0.3.0 (runes); @comvi/nuxt supports both Nuxt 3 and Nuxt 4.
Core & plugins
Section titled “Core & plugins”| Package | Peer dependency | Supported range |
|---|---|---|
@comvi/core | — | no peer deps (framework-agnostic) |
@comvi/plugin-fetch-loader | @comvi/core | matches the installed @comvi/core |
@comvi/plugin-locale-detector | @comvi/core | matches the installed @comvi/core |
@comvi/plugin-in-context-editor | @comvi/core | matches the installed @comvi/core |
@comvi/plugin-in-context-editor ships its own Vue 3 UI internally; it does not require Vue in your app to function.
Build tooling
Section titled “Build tooling”| Package | Peer dependency | Supported range |
|---|---|---|
@comvi/vite-plugin | vite | ^5.0.0 || ^6.0.0 || ^7.0.0 || ^8.0.0 |
The Vite plugin is used by frameworks built on Vite (Vue, SolidJS, Svelte/SvelteKit, Astro) and works with the Vite version those frameworks bundle.
Node.js
Section titled “Node.js”| Package | Requirement |
|---|---|
@comvi/cli | Node >=22.0.0 |
Runtime packages (@comvi/core, framework bindings, @comvi/nuxt) | Node >=18.0.0 |
Building the @comvi/* packages from source | Node >=24.0.0, pnpm >=9.0.0 |
The CLI (comvi pull / comvi push / comvi typegen) requires Node 22 or newer (it bundles Vite 7+). The runtime packages declare engines.node >=18, so they install cleanly on Node 18/20/22+ — use whatever your framework supports.
TypeScript
Section titled “TypeScript”Type-safe translation keys (the Type Safety feature) work with any TypeScript that supports template-literal types — TypeScript 4.5+ in practice. There is no TypeScript peer dependency; the generated *.d.ts files are plain ambient declarations.