Managing Updates

Updating Node.js

Saas Wind runs a long-running Node.js server. It defaults to the current active LTS version of node

If you wish to change the Node.js version, you can do so by updating the engines.node property in the package.json file.

{
  "engines": {
    "node": "22.11.0"
  }
}

Within Saas Wind

When you create a new project using Saas Wind, a bunch of code is generated for you.

This code is completely yours and there is no way to update it other than making manual changes. This is both a good thing and a bad thing.

It’s good in the sense that you can tweak it to fit your specific use cases.

But it’s a challenge because as Saas Wind gets improvements there’s no way to get those automatically.

You have to keep track of the improvements in Saas Wind and make those updates yourself.

You shouldn’t feel compelled to keep up-to-date with the latest of the Saas Wind template. If what you’re using is working fine for you then just keep going with it.

Only adopt changes as you feel the need to do so. Feel free to peruse Saas Wind’s commit history anytime you’d like to see what updates could be made to your project.

How to update NPM dependencies

Another part of Saas Wind is the dependencies of the project.

These you will also have to keep up-to-date yourself, but there is a bit of an automated process to help you.

It’s important to update your packages to get new features, bug fixes, and security patches. NPM Check Updates is a CLI that will help you safely make those updates. You can watch this youtube video for a demonstration of how to do this.

See a list of packages that can be updated

NPM packages follow semantic versioning. This command will show you which packages can be updated and which major, minor, or patch versions are available.

npx npm-check-updates

Notice the colors:

• Green = (non-major version zero) patch updates
• Cyan = minor updates
• Red = major or version zero (0.y.z) updates

Update green patch versions first, all at once

Since green patch version updates are meant for backward-compatible bug fixes, it’s ok to update them all at once.

npx npm-check-updates -u --target patch
...
pnpm i

Note: npx npm-check-updates -u -t patch updates all patch versions, including major version zero patch versions, which can break your code. If all your patch updates are green, feel free to use this command instead to update them all at once.

Assuming package maintainers follow semantic versioning, updating patch versions shouldn’t break anything, but it’s good practice to re-run your tests before committing these changes.

pnpm run build
pnpm run preview

If all tests pass, commit your changes.

git add .
git commit -m "Updated patch versions"

Update cyan minor versions second, one by one

Minor version updates introduce new features in a backward-compatible way. This is exciting and it’s good practice to take some time to explore the new functionality and apply relevant updates to your code base or plan to apply them later. It’s recommended you do this package by package instead of all at once.

To check for the new package’s features, check its release notes on GitHub.

If you haven’t updated a fairly active package in a while, reading all its release notes can take some time. Take into consideration how important a package is for your project when choosing which to update first.

npx npm-check-updates -u --filter <package-with-cyan-minor-update>
pnpm i

Again, assuming package maintainers follow semantic versioning updating patch versions shouldn’t break anything, but it’s good practice to re-run your tests to make sure.

pnpm run build
pnpm run preview

If all tests pass, commit your changes.

git add .
git commit -m "Updated minor versions"

Update red versions third, one by one

Red updates can happen on patch or minor versions (for zero major version (0.y.z) packages) or major versions. Either way, they could be breaking changes. It’s recommended you read its release notes to see what changed and plan accordingly.

Again, you might want to take into consideration how important a package is for your project when choosing which to update first.

npx npm-check-updates -u -f <package-with-red-version-update>
pnpm i

Make sure you’ve made all relevant changes and that the tests pass.

pnpm run build
pnpm run preview

If all tests pass, commit your changes.

git add .
git commit -m "Updated <package-with-red-version-update> major version"

Then continue for each package.