risk

A smaller Danger JS runtime with a narrower scope: GitHub only, ESM only, Node 22.18+. Three runtime dependencies.

Full documentation lives at danger.systems/js — the Dangerfile API is the same.

Installation

yarn add risk --dev

Usage

Create a dangerfile.ts in your project root. Your project does not need "type": "module" — Dangerfiles are always evaluated as ESM:

import { danger, warn, fail, message, markdown } from "risk"

if (!danger.github.pr.body.length) {
  fail("Please add a description to your PR.")
}

const bigPR = danger.github.pr.additions + danger.github.pr.deletions > 500
if (bigPR) {
  warn("This PR is quite large. Consider splitting it up.")
}

message(`This PR modifies ${danger.git.modified_files.length} file(s).`)

Existing Dangerfiles that import { danger } from "danger" will also work — a built-in ESM loader handles the redirect at runtime. To get TypeScript support for the "danger" import, add "risk" to the types array in your tsconfig.json:

{
  "compilerOptions": {
    "types": ["risk"]
  }
}

Plugins

danger-plugin-* packages work unchanged, including the CommonJS ones — the loader redirects their danger import (or require) to risk, and they share the same results, so warn() from inside a plugin lands in the Danger comment.

import { danger, warn } from "risk"
import jest from "danger-plugin-jest"

schedule(jest())

Commands

danger ci — Run on CI against the current pull request.

danger ci [options]

| Option | Description | | --- | --- | | -d, --dangerfile <path> | Path to Dangerfile (default: dangerfile.ts) | | --id <id> | Unique identifier for this run (default: "Danger") | | -t, --text-only | Print to stdout instead of posting comments | | --fail-on-errors | Exit with code 1 if there are failures | | --new-comment | Always create a new comment | | --remove-previous-comments | Remove previous Danger comments | | --base-url <url> | GitHub API base URL (for GitHub Enterprise) | | --no-publish-check | Don't set a commit status | | -v, --verbose | Verbose logging |

danger --version prints the installed version.

danger pr <url> — Test your Dangerfile against an existing PR without posting comments.

danger pr https://github.com/owner/repo/pull/123

GitHub Actions

- run: yarn danger ci
  env:
    GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

For other CI providers, set DANGER_GITHUB_API_TOKEN and either DANGER_PR_URL or DANGER_REPO_SLUG + DANGER_PR_ID.

GitHub Enterprise

Set --base-url or the DANGER_GITHUB_API_BASE_URL environment variable to your GHE API endpoint.

What's different from Danger JS

• GitHub only — no GitLab or BitBucket support
• ESM only — no CommonJS, no Babel transpilation
• Node 22.18+ — uses native type stripping, fetch, parseArgs, styleText
• Single process — no subprocess/runner model
• No inline comments — fail/warn/message accept a file and line, but results are always rendered in the single Danger comment (as file#L12) rather than posted onto the diff
• 3 runtime deps — @octokit/rest, parse-diff, picomatch

Releasing

# Update CHANGELOG.md with the new version, then:
yarn release <patch|minor|major>

This bumps package.json, commits, tags, and pushes. The publish workflow handles creating the GitHub release and publishing to npm.