Skip to content

Add installer preflight checks for supported Node.js and npm versions #10

@kjw3

Description

@kjw3

Summary

Installation fails on environments that still have Node.js 18.x, with downstream npm errors from dependencies that require Node.js 20+.

Problem

The current install experience fails late during dependency installation instead of validating runtime prerequisites up front. Users encounter package-manager errors that obscure the actual requirement.

Expected behavior

The installer should check Node.js and npm versions before attempting installation and provide a single clear error if the environment is unsupported.

Acceptance criteria

  • install.sh checks the installed Node.js version before running npm install steps.
  • Unsupported versions fail fast with a clear message that states the minimum supported Node.js and npm versions.
  • The quickstart and prerequisites docs list the required versions in one place.
  • CI includes at least one guard that prevents accidental regression to unsupported version messaging.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions