This repository contains a collection of reusable GitHub composite actions for Node.js projects.
Composite actions run as steps inside the caller's job rather than as separate jobs, so the caller is responsible for runs-on, permissions, timeout-minutes, and actions/checkout.
Installs dependencies with pnpm and runs init, lint, build, and test scripts.
Path: ci-node
Usage:
name: CI
on:
push:
branches: [main]
pull_request:
branches: [main]
types: [opened, synchronize]
jobs:
ci:
runs-on: ubuntu-latest
timeout-minutes: 15
steps:
- uses: actions/checkout@v6
- uses: stevezhu/actions/ci-node@v2CI optimized for Turborepo monorepos. Runs lint, build, and test with --affected. Compose with checkout-turbo for the matching fetch-depth.
Path: ci-node-turbo
Usage:
name: CI
on:
push:
branches: [main]
pull_request:
branches: [main]
types: [opened, synchronize]
jobs:
ci:
runs-on: ubuntu-latest
timeout-minutes: 15
steps:
- uses: stevezhu/actions/checkout-turbo@v2
- uses: stevezhu/actions/ci-node-turbo@v2Checks out the repository with a fetch-depth sized for Turborepo's --affected diff base (PR commits + 1 on pull_request, 1 otherwise). Pair this with ci-node-turbo when you don't need a custom checkout.
Path: checkout-turbo
Usage:
steps:
- uses: stevezhu/actions/checkout-turbo@v2Runs lint/test/build then stages a publish to NPM with provenance using pnpm stage publish. Requires pnpm 11.3.0 or later, selected by the caller's packageManager field.
After the action completes, review the staged package and approve it with pnpm stage approve <stage-id> or on npmjs.com. Approval requires 2FA before the version becomes publicly available. The stage ID is printed in the action logs.
Path: npm-publish
Usage:
name: Publish
on:
release:
types: [published]
jobs:
publish:
runs-on: ubuntu-latest
timeout-minutes: 15
permissions:
contents: read
id-token: write
steps:
- uses: actions/checkout@v6
- uses: stevezhu/actions/npm-publish@v2
with:
npm-token: ${{ secrets.NPM_TOKEN }}Bumps the package.json version and opens a PR with the change.
Path: npm-bump-version
Usage:
name: Bump Package Version
on:
workflow_dispatch:
inputs:
version_type:
description: 'Version bump type'
required: true
default: 'patch'
type: choice
options:
- patch
- minor
- major
jobs:
bump-version:
runs-on: ubuntu-latest
timeout-minutes: 10
permissions:
contents: write
pull-requests: write
steps:
- uses: actions/checkout@v6
- uses: stevezhu/actions/npm-bump-version@v2
with:
version_type: ${{ inputs.version_type }}Validates PR titles follow the Conventional Commits specification.
Path: lint-pr-title
Usage:
name: Lint PR Title
on:
pull_request:
types:
- opened
- reopened
- edited
# - synchronize (if you use required Actions)
jobs:
main:
runs-on: ubuntu-latest
timeout-minutes: 5
permissions:
pull-requests: read
steps:
- uses: stevezhu/actions/lint-pr-title@v2