@beplus/setup-beplus

Composite GitHub Action collection for setting up the beplus Environment in GitHub Actions workflows.

---

Available Actions

cli

Installs the beplus CLI (@beplus/be and beplus) with optional npm authentication.

- uses: beplus/setup-beplus/cli@v2
  with:
    BE_CLI_VERSION: latest
    BE_NPM_AUTH: false

setup-git

Configures Git for secure operations using a GitHub App token.

- uses: beplus/setup-beplus/git@v2

Reusable workflows

The thirteen beplus/* library repositories each carried a copy of the same PR check and the same publish pipeline — 6,836 lines that differed, in most of them, by the package list alone. Both now live here once:

# .github/workflows/ci.yml
jobs:
  validate:
    uses: beplus/setup-beplus/.github/workflows/library-ci.yml@v2
    secrets: inherit
    with:
      packages: |
        packages/core/docs

# .github/workflows/publish.yml — keep your own triggers, share the pipeline
jobs:
  publish:
    uses: beplus/setup-beplus/.github/workflows/library-publish.yml@v2
    secrets: inherit
    with:
      packages: |
        packages/core/docs
      publish-to: "--to @beplus/docs"
      force-change-files: true

Every optional step is an input that defaults to OFF, so adopting these changes nothing: a repository states what it already did. scripts/verify-callers.mjs checks that, resolving each caller against the shared workflow and comparing the enabled steps to the file it replaced.

---

Quick Start

name: Example Workflow

on: push

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - uses: beplus/setup-beplus/cli@v2
        with:
          BE_CLI_VERSION: latest

      - uses: beplus/setup-beplus/git@v2

      - run: beplus --version

---

Documentation

See each action's README for detailed configuration options, prerequisites, and troubleshooting:

• beplus CLI Action
• beplus Git Action