Skip to content
stevezhuPublic

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

Reusable GitHub Composite Actions

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.

Available Actions

Node CI

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@v2

Node CI (Turbo)

CI 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@v2

Checkout (Turbo) {#checkout-turbo}

Checks 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@v2

NPM Staged Publish

Runs 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 }}

NPM Bump Version

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 }}

Lint PR Title

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

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages