Shared Workflows

Reusable GitHub Actions workflows for my projects.

Overview

This repository centralizes workflow logic that can be reused across multiple repositories. By keeping common automation in one place, each project can call the same validated workflows without duplicating YAML files.

Repository structure

• .github/workflows/ - reusable workflow templates
• .gitattributes - repository line-ending normalization settings
• .gitignore - local macOS metadata exclusions

Included workflows

1. Auto-approve owner PRs

The workflow in .github/workflows/auto-approve-owner-pr.yml approves pull requests created by the repository owner. The calling workflow must grant pull-requests: write permission.

2. Node.js CI

The workflow in .github/workflows/node-ci.yml provides a reusable Node.js build and test pipeline. All inputs are optional:

Input	Default	Description
node-version	24	Node.js version
package-manager	npm	Package manager setting retained for compatibility
cache	npm	actions/setup-node cache; set to an empty string to disable
working-directory	.	Directory containing package.json
install-command	npm ci	Dependency install command
build-command	npm run build --if-present	Build command
test-command	npm test	Test command

3. .NET CI

The workflow in .github/workflows/dotnet-ci.yml provides a reusable .NET restore/build/test pipeline. All inputs are optional:

Input	Default	Description
dotnet-version	9.0.x	.NET SDK version
working-directory	.	Directory containing the project or solution
restore-command	dotnet restore	Restore command
build-command	dotnet build --no-restore	Build command
test-command	dotnet test --no-build --verbosity normal	Test command

4. Jest tests

The workflow in .github/workflows/jest-tests.yml runs a Node.js test suite and optionally uploads coverage artifacts or appends a generated summary to the GitHub Actions job summary. All inputs are optional:

Input	Default	Description
node-version	24	Node.js version
working-directory	.	Directory containing the project
install-command	npm ci	Dependency install command
test-command	npm test -- --runInBand	Test command
coverage-path	Empty	Coverage path to upload; empty disables the artifact
summary-command	Empty	Command whose output is appended to the job summary

5. Cypress E2E tests

The workflow in .github/workflows/cypress-e2e-tests.yml runs Cypress browser tests and uploads screenshots and videos on failure. All inputs are optional:

Input	Default	Description
node-version	24	Node.js version
working-directory	.	Directory containing the app project
install-command	npm ci	Dependency install command
start-command	npm start	Command used to start the app
browser	chrome	Cypress browser

6. Automated package updates

The workflow in .github/workflows/auto-package-updates.yml updates dependencies and opens a dependency PR. All inputs are optional:

Input	Default	Description
node-version	24	Node.js version
working-directory	.	Directory containing the project
base-branch	main	Branch targeted by the PR
assignee	TheManOfTeel	GitHub username assigned to the PR
labels	dependencies	Labels applied to the PR
branch-name	dependency-updates-automated	Update PR branch name
pr-title	[BOT] Automated package updates	PR title
pr-body	Updated packages to their latest versions.	PR body
update-command	ncu -t minor -u	Dependency update command
install-command	npm install	Install command after updating

This workflow requires a GH_TOKEN secret with permission to write repository contents and pull requests. The caller can make it available with secrets: inherit.

Example usage

Auto-approve owner PRs

name: Approve owner pull requests

on:
  pull_request:
    types: [opened, synchronize, reopened]

jobs:
  auto-approve:
    permissions:
      pull-requests: write
    uses: <your-org>/SharedWorkflows/.github/workflows/auto-approve-owner-pr.yml@v1.0.0

Node.js CI

name: CI

on:
  pull_request:
    branches: [main]

jobs:
  checks:
    uses: <your-org>/SharedWorkflows/.github/workflows/node-ci.yml@v1.0.0
    with:
      working-directory: ./Source/ClientApp
      node-version: 24.x
      cache: npm
      install-command: npm ci
      build-command: npm run build --if-present
      test-command: npm test

.NET CI

name: CI

on:
  pull_request:
    branches: [main]

jobs:
  checks:
    uses: <your-org>/SharedWorkflows/.github/workflows/dotnet-ci.yml@v1.0.0
    with:
      working-directory: ./Source
      dotnet-version: 9.0.x
      restore-command: dotnet restore
      build-command: dotnet build --no-restore
      test-command: dotnet test --no-build --verbosity normal

Jest tests

jobs:
  test:
    uses: <your-org>/SharedWorkflows/.github/workflows/jest-tests.yml@v1.0.0
    with:
      working-directory: .
      install-command: npm ci
      test-command: npm run test:ci
      coverage-path: coverage/
      summary-command: node .github/scripts/jest-summary.js

Cypress E2E tests

jobs:
  e2e:
    uses: <your-org>/SharedWorkflows/.github/workflows/cypress-e2e-tests.yml@v1.0.0
    with:
      working-directory: .
      install-command: npm ci
      start-command: npm start
      browser: chrome

Automated package updates

name: Dependency updates

on:
  schedule:
    - cron: '0 2 * * 1,3,5'
  workflow_dispatch:

jobs:
  deps:
    uses: <your-org>/SharedWorkflows/.github/workflows/auto-package-updates.yml@v1.0.0
    secrets: inherit
    with:
      working-directory: .
      base-branch: main
      assignee: TheManOfTeel
      labels: dependencies

Notes

• This repository is intentionally lightweight and focused on shared automation.
• Reusable workflows should stay generic and accept inputs instead of hardcoding repo-specific values.
• Update workflow files here when the shared logic needs to change across projects.