drydock
HomeDocsFeedback

Package review before publish

Review the package that will ship.

Between your last code review and the public registry sit build scripts, bundler output, and CI credentials. Drydock holds the release while it is still private, diffs the exact artifact against the last published version, and pins every finding to a changed line. You make the final call.

npm stage publishpypi / npm / vs code workflow gatesno publish credential

Create accountSign in

What a review looks like

A condensed report. Select a file in the release tree to walk the diff.

@acme/cli

scan_01HXY5K9PNQE3

4.2.0 → 4.3.017 files4 changedcomplete

block manual approvalrelease critical3 findings
findings by severity3 total
  • critical · 2
  • medium · 1
modifiedpackage.json
4.2.0 → 4.3.0
33 "version": "4.3.0",
44 "main": "lib/index.js",
55 "scripts": {
66 "build": "tsc -p .",
7+ "postinstall": "node lib/install.js",
78 "test": "vitest"
89 },
criticallifecycle script added · line 7

postinstall now executes during every npm install, invoking lib/install.js, a file new in this release. Select it in the tree to see why this release is blocked.

Sponsored by

Aikido Securityaikido.dev →

Why review a publish

The attacks that matter ship in the artifact.

A pull request review checks the source tree. The registry serves something else: a built artifact that can carry install hooks, minified bundles, and files that never lived in git, published with a credential that may not belong to the person you think. Once a version is live it is immutable and installed within minutes. The last useful checkpoint sits between the finished artifact and the registry — and that is the one almost nobody looks at.

  • event-stream

    2018publish rights handed over

    A volunteer co-maintainer published a wallet-drainer aimed at Copay. The payload existed only in the npm tarball — the GitHub repository never showed it.

  • ua-parser-js

    2021hijacked npm account

    Three malicious versions carried a cryptominer and a credential stealer. The repository was untouched; only the published artifacts were compromised.

  • node-ipc

    2022maintainer's own publish

    A legitimate credential shipped a payload that overwrote files based on the installer's IP address. Nothing about the account looked wrong.

  • chalk & debug

    2025phished maintainer

    One phishing email compromised 18 packages with about two billion combined weekly downloads. The crypto-stealing versions were live for hours before anyone diffed them.

None of these appeared in a pull request. Every one shipped through a publish nobody reviewed.

How it works

  1. 01

    Hold the release candidate

    A maintainer stages an npm publish, or a GitHub Environment gate pauses the publish job after CI uploads built artifacts. The candidate stays private while Drydock can inspect it.

  2. 02

    Review the artifact, not the branch

    Drydock compares the candidate with the last published version, flags risky deltas like install scripts, process execution, network access, credential reads, and new binaries, then anchors each finding to the diff. Package contents are never executed.

  3. 03

    Let a maintainer decide

    Approve the npm publish yourself with 2FA, or approve or reject the gated GitHub job from the workbench. Drydock gives you the review; it never publishes and never holds your publish credential.

How it hooks in

npm stage publish

A maintainer runs npm stage publish and the registry parks a private candidate. Drydock reviews that tarball and pins risk signals to the diff before the maintainer completes npm's 2FA confirmation.

Workflow gating: PyPI, npm & VS Code

Preview

For PyPI, VS Code extensions, or npm workflows that do not stage, a GitHub Environment pauses the publish job after CI uploads the release artifact. Drydock reviews the upload, the maintainer approves or rejects, and, if approved, the job continues with its own credential.

Read the docs →

Safeguards

credentialsscoped

Scoped tokens only fetch release evidence. Publish credentials stay in npm or GitHub Actions, not in Drydock.

retentionredacted

Reports keep redacted review evidence instead of raw release archives.

approvalhuman

Maintainers make the release decision: npm 2FA for a stage publish or the CI gate for workflow releases.

Get started

Put your next release in the dock.

Stage an npm publish or add a workflow gate to your release job. Setup takes minutes, and from then on every version gets a second pair of eyes before it can ship.

Create accountRead the docs

free for open-source maintainersread-only tokensyou keep the final approval