feat: sync `modules.json` compatibility/docs from modules by danielroe · Pull Request #1353 · nuxt/modules

danielroe · 2026-01-08T21:02:26Z

🔗 Linked issue

❓ Type of change

📖 Documentation (updates to the documentation or readme)
🐞 Bug fix (a non-breaking change that fixes an issue)
👌 Enhancement (improving an existing functionality)
✨ New feature (a non-breaking change that adds functionality)
🧹 Chore (updates to the build process or auxiliary tools and libraries)
⚠️ Breaking change (fix or feature that would cause existing functionality to change)

📚 Description

this uses module.json (emitted by nuxt/module-buidler) as source of truth for module compatibility + docs urls

we'll need to keep an eye on this - some modules seem to have incorrect compatibility (e.g. ^3.0.0 as opposed to >=3.0.0) so we can raise some upstream PRs

danielroe · 2026-01-08T21:24:05Z

modules/lodash.yml

    github: cipami
 compatibility:
-  nuxt: '>=3.0.0'
+  nuxt: ^3.0.0


note - we need to open a PR upstream

Repo is archived: https://github.com/cipami/nuxt-lodash

What do you think of removing it instead?

danielroe · 2026-01-08T21:26:22Z

modules/xstate.yml

    twitter: lexpeartha
 compatibility:
-  nuxt: ^2.0.0 || >=3.0.0
+  nuxt: ^2.16.0 || ^3.0.0


note: needs PR

danielroe · 2026-01-08T21:26:29Z

modules/well-known.yml

    github: https://github.com/zadigetvoltaire
 compatibility:
-  nuxt: '>=3.0.0'
+  nuxt: ^3.0.0


note: needs PR

danielroe · 2026-01-08T21:26:34Z

modules/web-vitals.yml

    bluesky: atinux.com
 compatibility:
-  nuxt: ^2.0.0 || >=3.0.0
+  nuxt: ^3.0.0 || ^2.15.0


note: needs PR

danielroe · 2026-01-08T21:26:40Z

modules/vue-query.yml

    twitter: its_hebilicious
 compatibility:
-  nuxt: '>=3.0.0'
+  nuxt: ^3


note: needs PR

danielroe · 2026-01-08T21:26:43Z

modules/vue-email.yml

    avatar: https://avatars.githubusercontent.com/u/35883748?v=4
 compatibility:
-  nuxt: '>=3.0.0'
+  nuxt: ^3.0.0


note: needs PR

danielroe · 2026-01-08T21:26:48Z

modules/vcalendar.yml

    github: samk-dev
 compatibility:
-  nuxt: '>=3.0.0'
+  nuxt: ^3.0.0


note: needs PR

danielroe · 2026-01-08T21:27:25Z

modules/radash.yml

    github: bbg
 compatibility:
-  nuxt: '>=3.0.0'
+  nuxt: ^3.0.0


note: needs PR

danielroe · 2026-01-08T21:27:32Z

modules/purgecss.yml

    github: Developmint
 compatibility:
-  nuxt: ^2.0.0 || >=3.0.0
+  nuxt: ^3.0.0-rc.11


note: needs PR

You already opened it @danielroe
Developmint/nuxt-purgecss#199

danielroe · 2026-01-08T21:27:49Z

modules/particles.yml

    avatar: https://avatars.githubusercontent.com/Joepocalyptic?v=4
 compatibility:
-  nuxt: '>=3.0.0'
+  nuxt: ^3.7.0


note: needs PR

Joepocalyptic/nuxt-particles#33

danielroe · 2026-01-08T21:27:54Z

modules/nuxt-uswds.yml

    github: patrickcate
 compatibility:
-  nuxt: '>=3.0.0'
+  nuxt: ^3.0.0


note: needs PR

atinux · 2026-01-09T09:12:30Z

modules/lodash.yml

    github: cipami
 compatibility:
-  nuxt: '>=3.0.0'
+  nuxt: ^3.0.0


Repo is archived: https://github.com/cipami/nuxt-lodash

What do you think of removing it instead?

atinux · 2026-01-09T09:18:02Z

modules/nuxt-chatgpt.yml

    github: schnapsterdog
 compatibility:
-  nuxt: '>=3.0.0'
+  nuxt: '>=3.0.0 <5.0.0'


Opened SchnapsterDog/nuxt-chatgpt#36 to avoid having this <5

atinux · 2026-01-09T09:21:48Z

modules/particles.yml

    avatar: https://avatars.githubusercontent.com/Joepocalyptic?v=4
 compatibility:
-  nuxt: '>=3.0.0'
+  nuxt: ^3.7.0


Joepocalyptic/nuxt-particles#33

atinux · 2026-01-09T09:22:24Z

modules/purgecss.yml

    github: Developmint
 compatibility:
-  nuxt: ^2.0.0 || >=3.0.0
+  nuxt: ^3.0.0-rc.11


You already opened it @danielroe
Developmint/nuxt-purgecss#199

danielroe · 2026-01-09T09:32:21Z

here's the full list of modules that mark themselves as compatible with 3.x but not 4.x:

danielroe · 2026-01-14T17:10:51Z

here's the latest:

Regressions detected (36):
  - [compatibility] ark-ui: Module was marked as Nuxt 4 compatible (>=3.0.0) but module.json indicates only ^3.0.0
  - [compatibility] api-party: Module was marked as Nuxt 4 compatible (>=3.0.0) but module.json indicates only ^3.0.0
  - [compatibility] cloudflare-analytics: Module was marked as Nuxt 4 compatible (>=3.0.0) but module.json indicates only ^3.0.0
  - [docs-url] contentstack: Module had a documentation site (https://nuxt-contentstack-docs.eu-contentstackapps.com/) but module.json now points to https://github.com/timbenniks/nuxt-contentstack
  - [compatibility] bugsnag: Module was marked as Nuxt 4 compatible (^2.0.0 || >=3.0.0) but module.json indicates only ^2.16.0 || ^3.0.0-rc.10
  - [compatibility] google-adsense: Module was marked as Nuxt 4 compatible (^2.0.0 || >=3.0.0) but module.json indicates only ^2.15.0 || ^3.0.0-rc.11
  - [compatibility] gtag: Module was marked as Nuxt 4 compatible (>=3.0.0) but module.json indicates only ^3.0.0
  - [compatibility] icons: Module was marked as Nuxt 4 compatible (>=3.0.0) but module.json indicates only ^3.0.0-rc.3
  - [compatibility] jsonapi: Module was marked as Nuxt 4 compatible (^2.0.0 || >=3.0.0) but module.json indicates only ^3.0.0
  - [compatibility] lodash: Module was marked as Nuxt 4 compatible (>=3.0.0) but module.json indicates only ^3.0.0
  - [compatibility] link-checker: Module was marked as Nuxt 4 compatible (>=3.0.0) but module.json indicates only ^3.0.0
  - [compatibility] meilisearch: Module was marked as Nuxt 4 compatible (>=3.0.0) but module.json indicates only ^3.0.0-rc.9
  - [compatibility] nuxt-facebook-chat: Module was marked as Nuxt 4 compatible (>=3.0.0) but module.json indicates only ^3.6.0
  - [compatibility] nuxt-gpt: Module was marked as Nuxt 4 compatible (>=3.0.0) but module.json indicates only ^3.0.0
  - [compatibility] nuxt-gtm: Module was marked as Nuxt 4 compatible (>=3.0.0) but module.json indicates only ^3.0.0
  - [compatibility] nuxt-graphql-middleware: Module was marked as Nuxt 4 compatible (^2.0.0 || >=3.0.0) but module.json indicates only ^3.0.0
  - [compatibility] nuxt-localtunnel: Module was marked as Nuxt 4 compatible (>=3.0.0) but module.json indicates only ^3.0.0
  - [compatibility] nuxt-legacy: Module was marked as Nuxt 4 compatible (>=3.15.0) but module.json indicates only ^3.0.0 || >=4.0.3
  - [compatibility] nuxt-plotly: Module was marked as Nuxt 4 compatible (>=3.0.0) but module.json indicates only ^3.6.0
  - [compatibility] nuxt-uswds: Module was marked as Nuxt 4 compatible (>=3.0.0) but module.json indicates only ^3.0.0
  - [compatibility] pdfeasy: Module was marked as Nuxt 4 compatible (>=3.0.0) but module.json indicates only ^3.0.0
  - [compatibility] particles: Module was marked as Nuxt 4 compatible (>=3.0.0) but module.json indicates only ^3.7.0
  - [compatibility] og-image: Module was marked as Nuxt 4 compatible (>=3.0.0) but module.json indicates only ^3.0.0
  - [compatibility] purgecss: Module was marked as Nuxt 4 compatible (^2.0.0 || >=3.0.0) but module.json indicates only ^3.0.0-rc.11
  - [compatibility] radash: Module was marked as Nuxt 4 compatible (>=3.0.0) but module.json indicates only ^3.0.0
  - [compatibility] rollbar: Module was marked as Nuxt 4 compatible (>=3.0.0) but module.json indicates only ^3
  - [compatibility] snipcart: Module was marked as Nuxt 4 compatible (^2.0.0 || >=3.0.0) but module.json indicates only ^3.0.0
  - [compatibility] supabase: Module was marked as Nuxt 4 compatible (^2.0.0 || >=3.0.0) but module.json indicates only ^3.0.0-rc.8
  - [compatibility] typed-router: Module was marked as Nuxt 4 compatible (^2.0.0 || >=3.0.0) but module.json indicates only ^3.0.0-rc.1
  - [compatibility] umami: Module was marked as Nuxt 4 compatible (^2.0.0 || >=3.0.0) but module.json indicates only ^2.0.0 || ^3.0.0-rc.9
  - [compatibility] vcalendar: Module was marked as Nuxt 4 compatible (>=3.0.0) but module.json indicates only ^3.0.0
  - [compatibility] vue-query: Module was marked as Nuxt 4 compatible (>=3.0.0) but module.json indicates only ^3
  - [compatibility] vue-email: Module was marked as Nuxt 4 compatible (>=3.0.0) but module.json indicates only ^3.0.0
  - [compatibility] web-vitals: Module was marked as Nuxt 4 compatible (^2.0.0 || >=3.0.0) but module.json indicates only ^2.15.0 || ^3.0.0
  - [compatibility] well-known: Module was marked as Nuxt 4 compatible (>=3.0.0) but module.json indicates only ^3.0.0
  - [compatibility] xstate: Module was marked as Nuxt 4 compatible (^2.0.0 || >=3.0.0) but module.json indicates only ^2.16.0 || ^3.0.0

danielroe · 2026-01-14T17:48:45Z

current status:

Module	Status	PR Link
ark-ui	Existing PR open	iamdin/nuxt-ark-ui#32
cloudflare-analytics	Existing PR open	hamlogic/nuxt-cloudflare-analytics#9
contentstack	Resolved - yml already updated	N/A
jsonapi	PR created	patrickcate/nuxt-jsonapi#644
lodash	Existing PR open	cipami/nuxt-lodash#62
nuxt-facebook-chat	Source already correct (>=3.6.0), needs npm publish	N/A
nuxt-gpt	Existing PR open	holux-design/nuxt-GPT#1
nuxt-gtm	Existing PR open	zadigetvoltaire/nuxt-gtm#34
nuxt-legacy	Source already correct (^3.18.0 \|\| >=4.0.3), needs npm publish	N/A
nuxt-localtunnel	Existing PR open	nuxtus/localtunnel#28
nuxt-plotly	PR created	superdev-tech/nuxt-plotly#12
nuxt-uswds	Existing PR open	patrickcate/nuxt-uswds#59
particles	Existing PR open	Joepocalyptic/nuxt-particles#25
pdfeasy	Source already correct (>=3.0.0), needs npm publish	N/A
purgecss	Source already correct (>=3.0.0-rc.11), needs npm publish	N/A
radash	Existing PR open	bbg/nuxt-radash#4
rollbar	Source already correct (>=3), needs npm publish	N/A
snipcart	Source already correct (>=3.0.0), needs npm publish	N/A
vcalendar	Existing PR open	samk-dev/nuxt-vcalendar#27
vue-email	Repo archived - cannot create PR	N/A
vue-query	Source already correct (>=3), needs npm publish	N/A
web-vitals	Existing PR open	nuxt-modules/web-vitals#87
well-known	Source already correct (>=3.0.0), needs npm publish	N/A
xstate	Existing PR open	Lexpeartha/nuxt-xstate#60

apologies for the mass ping, but:

would you mind merging the PR (or closing it if you don't intend to support nuxt v4+): @iamdin @hamlogic @madebyfabian @patrickcate @cipami @holux-design @zadigetvoltaire @craigharman @Boomgeek @superdev-tech @Joepocalyptic @bbg @samk-dev @daliborgogic @pi0 @Lexpeartha
would you mind publishing a new version of your package so users can install the module on nuxt v4+: @Boomgeek @superdev-tech @Teages @Novout @Developmint @jairoblatt @flozero @Hebilicious @zadigetvoltaire

thank you - and apologies for the noise 🙏

feat: sync modules.json compatibility/docs from modules

6ad2fcb

danielroe requested a review from atinux January 8, 2026 21:02

danielroe self-assigned this Jan 8, 2026