Skip to content

Add engines Entry to package.json to Specify Required Node.js Versions #30547

@MikaStark

Description

@MikaStark

Which @angular/* package(s) are relevant/related to the feature request?

core

Description

Hello Angular Team,

When starting a new Angular project, it's not immediately clear which Node.js versions are compatible—especially when working with older Angular versions. Unless developers check the Version Compatibility documentation, they may unknowingly use an unsupported Node.js version, leading to confusing errors.

Proposed solution

A simple and effective solution would be to include an engines field in the generated package.json:

{
  // ...
  "engines": {
    "node": "^20.19.0 || ^22.12.0 || ^24.0.0"
  },
}

This is a standard Node.js feature that many tools and platforms (e.g., DigitalOcean, Vercel) can use to select the appropriate runtime environment during deployment or CI builds.

Alternatives considered

Optionally, generating an .nvmrc file could help local development, but the engines field provides broader support and clearer intent.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

      Development

      No branches or pull requests

        Participants

        @alan-agius4@MikaStark

        Issue actions

          Add engines Entry to package.json to Specify Required Node.js Versions · Issue #30547 · angular/angular-cli