# ivuorinen/actions/node-setup

## Node Setup

### Description

Sets up Node.js environment with version detection and package manager configuration.

### Inputs

| name              | description                                                              | required | default                      |
|-------------------|--------------------------------------------------------------------------|----------|------------------------------|
| `default-version` | <p>Default Node.js version to use if no configuration file is found.</p> | `false`  | `22`                         |
| `package-manager` | <p>Node.js package manager to use (npm, yarn, pnpm, bun, auto)</p>       | `false`  | `auto`                       |
| `registry-url`    | <p>Custom NPM registry URL</p>                                           | `false`  | `https://registry.npmjs.org` |
| `token`           | <p>Auth token for private registry</p>                                   | `false`  | `""`                         |
| `node-mirror`     | <p>Custom Node.js binary mirror</p>                                      | `false`  | `""`                         |
| `force-version`   | <p>Force specific Node.js version regardless of config files</p>         | `false`  | `""`                         |

### Outputs

| name              | description                         |
|-------------------|-------------------------------------|
| `node-version`    | <p>Installed Node.js version</p>    |
| `package-manager` | <p>Selected package manager</p>     |
| `node-path`       | <p>Path to Node.js installation</p> |

### Runs

This action is a `composite` action.

### Usage

```yaml
- uses: ivuorinen/actions/node-setup@main
  with:
    default-version:
    # Default Node.js version to use if no configuration file is found.
    #
    # Required: false
    # Default: 22

    package-manager:
    # Node.js package manager to use (npm, yarn, pnpm, bun, auto)
    #
    # Required: false
    # Default: auto

    registry-url:
    # Custom NPM registry URL
    #
    # Required: false
    # Default: https://registry.npmjs.org

    token:
    # Auth token for private registry
    #
    # Required: false
    # Default: ""

    node-mirror:
    # Custom Node.js binary mirror
    #
    # Required: false
    # Default: ""

    force-version:
    # Force specific Node.js version regardless of config files
    #
    # Required: false
    # Default: ""
```