Docs

Appearance

v3.3.1, 05-08-2025 ​

Highlights ​

  • MongoDB Driver Upgrades

    • Upgraded core MongoDB driver to 6.16.0 to address latest issues reported #13710
    • Introduced npm-mongo-legacy to maintain compatibility with MongoDB 3.6 via mongodb@6.9.0 #13736
    • Mitigated a cursor leak issue by synchronizing next() and close() operations #13786

  • Improved SWC integration

    • Fixed edge cases in config cache invalidation #13809
    • Ensured @swc/helpers is consistently used for better bundle size and performance #13820
    • Updated to SWC 1.12.14 #13851

  • Tooling and Build System

    • Fixed regression affecting rebuild behavior #13810
    • Addressed issues getting performance profiles in mounted volumes #13827
    • Fallback to Babel parser when Acorn fails to parse source code #13844

  • Mobile Support

    • Upgraded Cordova platform to version 14 #13837

  • Developer Experience

    • Added TypeScript types for isModern and getMinimumBrowserVersions functions #13704
    • Enhanced CLI help output and documented admin commands #13826

  • Vite Tooling

    • Updated official Meteor + Vite skeletons #13835

  • Runtime & Dependencies

    • Updated to Node.js 22.18.0 and NPM 10.9.3 #13877
    • Bumped meteor-node-stubs to 1.2.21 #13825

All Merged PRs@GitHub PRs 3.3.1

Breaking Changes ​

MongoDB Driver Upgrades ​

If you're using MongoDB 3.6 or earlier, install the new legacy package:

bash
meteor add npm-mongo-legacy

This will pin the MongoDB driver to 6.9.0 for compatibility.

If you’re on MongoDB 4+, the default MongoDB driver 6.16.0 is applied automatically.

Please migrate your database as soon as possible to MongoDB 5 onward, as MongoDB driver 6.17.0 will drop MongoDB 4 support. We’ll keep offering npm-mongo-legacy so you can keep getting Meteor updates with your existing MongoDB legacy version.

Cordova Upgrade ​

The Cordova platform has been upgraded to version 14. Refer to the Cordova Changelog for more details on the changes and migration steps.

Internal API changes ​

N/A

Migration Steps ​

Please run the following command to update your project:

bash
meteor update --release 3.3.1

While this is a patch release, Meteor 3.3, a recent minor update, introduced a modern build stack that’s now the default for new apps. Here’s how you can migrate to it.

Add this to your package.json to enable the new modern build stack:

json
"meteor": {
  "modern": true
}

Check the docs for help with the SWC migration, especially if your project uses many Babel plugins.

Modern Transpiler: SWC docs

If you find any issues, please report them to the Meteor issues tracker.

Bumped Meteor Packages ​

  • babel-compiler@7.12.1
  • callback-hook@1.6.1
  • ecmascript@0.16.12
  • minifier-js@3.0.3
  • minimongo@2.0.3
  • modern-browsers@0.2.3
  • mongo@2.1.3
  • npm-mongo-legacy@6.9.0
  • npm-mongo@6.16.0
  • standard-minifier-js@3.1.1
  • tinytest@1.3.2
  • typescript@5.6.5
  • meteor-tool@3.3.1

Bumped NPM Packages ​

  • meteor-node-stubs@1.2.21

Special thanks to ​

✨✨✨

✨✨✨