Setup Node.js Pro Environment
ActionsTags
(2)
The smartest way to set up Node.js in GitHub Actions.
Zero guesswork. Maximum speed. Built for modern CI.
Please note: We take our GitHub action's security and users' trust very seriously. If you believe you have found a security issue in any of our GitHub action, please responsibly disclose by contacting us at security@anantacloud.com.
Most Node setup actions stop at installation.
This one goes further.
- Auto-detects package manager (npm, yarn, pnpm)
- Supports
.nvmrc,.node-version,package.json,.tool-versions - Semver-aware version resolution
- Cross-platform (Linux, macOS, Windows)
- Built-in dependency install
- Matrix-aware intelligent caching
- Registry + authentication support
- Mirror support for Node.js binaries
- Debug mode for deep CI visibility
Think of it as setup-node, but evolved.
- name: Setup Node.js
uses: anantacloud-actions/setup-node@v1- uses: anantacloud-actions/setup-node@v1
with:
node-version: 20- uses: anantacloud-actions/setup-node@v1
with:
node-version-file: .nvmrc- uses: anantacloud-actions/setup-node@v1
with:
cache: npm- uses: anantacloud-actions/setup-node@v1
with:
registry-url: https://registry.npmjs.org
token: ${{ secrets.NPM_TOKEN }}- uses: anantacloud-actions/setup-node@v1
with:
install: false| Name | Description | Required | Default |
|---|---|---|---|
node-version |
Version spec (e.g. 18, 20.x, >=18.0.0) | ❌ | - |
node-version-file |
File with version (e.g. .nvmrc, package.json) | ❌ | - |
architecture |
Target architecture (x86, x64, arm64) | ❌ | system |
check-latest |
Resolve latest matching version | ❌ | false |
registry-url |
Registry URL for npm/yarn/pnpm | ❌ | - |
scope |
Scope for registry authentication | ❌ | repo owner |
token |
Auth token for registry or downloads | ❌ | github token |
cache |
Package manager cache (npm, yarn, pnpm) | ❌ | auto |
package-manager-cache |
Enable/disable automatic caching | ❌ | true |
cache-dependency-path |
Path(s) to dependency files | ❌ | auto |
mirror |
Alternative Node.js download mirror | ❌ | nodejs.org |
mirror-token |
Token for mirror authentication | ❌ | - |
install |
Install dependencies automatically | ❌ | true |
debug |
Enable debug logging | ❌ | false |
| Name | Description |
|---|---|
node-version |
Installed Node.js version |
node-versionnode-version-file- Error if none provided
| File Found | Manager |
|---|---|
| pnpm-lock.yaml | pnpm |
| yarn.lock | yarn |
| none | npm |
| Manager | Command |
|---|---|
| npm | npm ci |
| yarn | yarn install --frozen-lockfile |
| pnpm | pnpm install --frozen-lockfile |
Cache key includes:
- OS
- Architecture
- Node version
- Lockfile hash
Result: faster and more reliable CI runs.
Supports:
- npm registry
- GitHub Packages
- Custom registries
Automatically configures .npmrc.
Use custom mirror for faster downloads or internal networks.
| Feature | setup-node | Setup Node.js Pro |
|---|---|---|
| Auto detect package manager | ❌ | ✅ |
| Built-in install | ❌ | ✅ |
| Debug logs | ❌ | ✅ |
| Matrix-aware cache | ✅ | |
| Version file support | ✅ | |
| Mirror support | ❌ | ✅ |
- Monorepos (pnpm / yarn workspaces)
- Enterprise CI pipelines
- Multi-version testing
- Air-gapped environments (mirror support)
- Zero-config projects
If this project helps you, consider giving it a ⭐
It helps others discover it.
PRs, issues, and suggestions are welcome.
MIT
Setup Node.js Pro Environment is not certified by GitHub. It is provided by a third-party and is governed by separate terms of service, privacy policy, and support documentation.
About
Tags
(2)Setup Node.js Pro Environment is not certified by GitHub. It is provided by a third-party and is governed by separate terms of service, privacy policy, and support documentation.