A GitHub Action to automatically update you repository to the latest Node.js versions. Supports updating GitHub workflows, package.json engines and arbitrary files.

• Usage
• Versions
• Updaters
• Inputs
• Outputs

This example workflow will check for new Node versions every Sunday at 7:30 AM. If a new version is found, versions are updated, the changes will be automatically committed to a new branch and a pull request created.

# .github/workflows/update-node-versions.yml
name: update-node-versions

on:
  schedule:
    - cron: "30 7 * * 0"

jobs:
  update-node-versions:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - uses: hongaar/update-node-versions@v2
      - uses: peter-evans/create-pull-request@v5
        with:
          title: "feat: update node.js versions"
          body: |
            Automated changes by [update-node-versions](https://github.com/hongaar/update-node-versions) GitHub action

            BREAKING CHANGE: This updates the supported node.js versions
          token: ${{ secrets.GH_PAT }}

Note: If you're using updaters.workflows (enabled by default), the peter-evans/create-pull-request action needs a Personal Access Token with write access to 'pull requests' and 'workflows' (fine-grained tokens) or 'repo'/'public_repo' and 'workflow' scopes (classic token). The default secrets.GITHUB_TOKEN does not have the required permissions.

By default, versions will be updated to reflect the 'current' and 'LTS' versions of Node which are not end-of-life.

Optionally, you can configure the action to use another strategy for selecting Node versions.

You can configure which parts of your repository are updated. By default, the GitHub workflows and Engines updaters are enabled. These updaters are available:

• GitHub workflows
  This will scan all your GitHub workflows for a node-version variable in a matrix strategy and update them accordingly. The name of the variable can be configured.

  strategy:
    matrix:
      node-version: [18, 20, 21]

• Engines
  This will update the engines field in your package.json file. It will use the lowest Node version as the minimal supported version.

  {
    "engines": {
      "node": ">=18"
    }
  }

• Files
  This will update arbitrary files in your repository. You can specify a glob pattern of files to update, a regex to match and a replacement template to replace the matches with. Files in node_modules are ignored. You can use these tags in the template:

  tag	output example
  $1, $2, etc.	Match group
  ${versions}	18, 20, 21
  ${minVersion}	18
  ${maxVersion}	21

  Note: You can specify a list of glob patterns by specifying each pattern on a new line. If you also provide a list regexes and templates, each glob pattern will use the respective line in the regex and template inputs.

latest
lts
lts/-1
lts/-2

All inputs are optional. Example:

- uses: hongaar/update-node-versions@v1
  with:
    versions: |
      current
      lts
      lts/-1
      lts/-2
    versions.filter-eol: true
    updaters.workflows: true
    updaters.workflows.variable: node
    updaters.engines: false