Migrating from FormVueLate 3.x to 4.x

3.x and 2.x are no longer maintained

FormVueLate was archived in June 2022 and remained dormant until the 4.x revival. The 3.x docs site (formvuelate.js.org before 4.x) and the 2.x docs site are both frozen snapshots — they do not reflect any active maintenance. The old code is still accessible through the v3.9.1 and v2.x git tags if you specifically need it, but everyone should upgrade to 4.x going forward.

FormVueLate 4.0 is primarily a modernization release. The public API (SchemaForm, useSchemaForm, SchemaFormFactory, definePlugin) is unchanged. Most consumers will only need to bump peer dependencies and re-install.

Breaking changes

Vue 3.4+ required

The minimum supported Vue version is now ^3.4.0 (was ^3.0.0). If you're on Vue 3.0–3.3, upgrade Vue first.

Node 20.19+ for development

engines.node is >=20.19.0 for building/contributing, and the repo pins Node 24 LTS in .nvmrc. Because this engine range is published in package metadata, consumers installing on older Node versions may see engine warnings or install failures when engine-strict is enabled, even if their usage would otherwise be runtime-only.

UMD bundles dropped

The formvuelate.umd.js / formvuelate.umd.min.js files are gone. Use a bundler (Vite, Rollup, esbuild, webpack) instead of script tags. The package exposes a standard exports map for ES and CJS.

Vuelidate plugin removed

The @formvuelate/plugin-vuelidate package was marked WIP for years and never shipped. It is not part of 4.0. A future Regle-based plugin may take its place in a later 4.x.

vee-validate peer bumped

@formvuelate/plugin-vee-validate now requires vee-validate@^4.13. If you're below that, bump first.

CDN deep imports may break

If you were importing from formvuelate/dist/formvuelate.cjs.js directly, switch to the package root (import { SchemaForm } from 'formvuelate'). Deep imports beyond the exports map are unsupported.

Migration checklist

# 1. Bump peer dependencies
pnpm add vue@^3.4 vee-validate@^4.13

# 2. Bump formvuelate + plugins to 4.0
pnpm add formvuelate@^4 @formvuelate/plugin-lookup@^4 @formvuelate/plugin-vee-validate@^4

# 3. Drop any imports of @formvuelate/plugin-vuelidate (the package is no longer published)

# 4. Remove any direct deep imports from formvuelate/dist/*

If you only consume <SchemaForm> and the plugins through SchemaFormFactory, you're done — no code changes needed.