Guides, 
Usage, 
Tutorials, 
Reference & 
Playground

Looking for  or ?

a project from orta therox,
and the Danger org contributors.

What is Danger JS?

Danger runs during your CI process, and gives teams the chance to automate common code review chores.

This provides another logical step in your build, through this Danger can help lint your rote tasks in daily code review.

You can use Danger to codify your teams norms. Leaving humans to think about harder problems.

This happens by Danger leaving messages inside your PRs based on rules that you create with JavaScript or TypeScript.

Over time, as rules are adhered to, the message is amended to reflect the current state of the code review.

How does it work?

Danger is a NPM module that evals a Dangerfile. You set up a Dangerfile per-project. The Dangerfile contains a collection of home-grown rules specific to your project as a dangerfile.js or dangerfile.ts.

Danger can be installed via NPM or Yarn.

Use yarn add danger -D to add it to your package.json.

You can integrate Danger into your own project using AppCenter, Bamboo, BitbucketPipelines, Bitrise, BuddyBuild, BuddyWorks, Buildkite, Circle, Cirrus, CodeBuild, Codefresh, Codemagic, Codeship, Concourse, DockerCloud, Drone, GitHubActions, GitLabCI, Jenkins, Netlify, Nevercode, Screwdriver, Semaphore, Surf, TeamCity, Travis, VSTS.

You would then need to generate a GitHub access token or a BitBucket Server user, and expose some credentials as ENV vars. Then add `yarn danger ci` to your CI test run.

The Getting Started guide covers this in more detail.

// Import the feedback functions
import { message, warn, fail, markdown } from "danger"

// Add a message to the table
message("You have added 2 more modules to the app")

//  Adds a warning to the table
warn("You have not included a CHANGELOG entry.")

// Declares a blocking 
fail(`ESLint has failed with ${fails} fails.`)

// Show markdown under the table:
markdown("## New module Danger" + dangerYarnInfo)

Get Started

What does this Look like?

Enforce changelogs
Keep Lockfile up to date
Encourage smaller PRs
Ensure PRs have assignees
Encourage more testing
Highlight documentation updates
Show useful info on a PR
Ensure Project Consistency
Highlight SemVer breakages

// Add a CHANGELOG entry for app changes
const hasChangelog = danger.git.modified_files.includes("changelog.md")
const isTrivial = (danger.github.pr.body + danger.github.pr.title).includes("#trivial")

if (!hasChangelog && !isTrivial) {
  warn("Please add a changelog entry for your changes.")
}

Repo: danger/danger-js

What is Danger JS?

How does it work?

What does this Look like?

Lots of documentation

Getting Started with Danger JS

CHANGELOG

Extending Danger

Danger in a Node App

Danger + Node Library

About the Dangerfile

Cultural Changes

Danger + Dependencies

Danger in my Language

Danger + Transpilation

FAQ

Danger + BitBucket Cloud

Danger + BitBucket Server

Danger + GitLab

Fast Feedback via Danger Local

Peril

Awesome plugins