← All projects
Developer Tools / CLI

DriftCheck

An open-source CLI that verifies a live deployment actually works, catching failures a green build hides.

Role
Creator
Status
Published on npm
Category
Developer Tools / CLI
TypeScriptNode.jsnpmGitHub Actions
91
Tests passing
Context

A green build does not mean a working deployment. DriftCheck is an open-source CLI for post-deploy verification: it checks that the live deployment actually works.

Approach

Test the thing users reach, not the thing CI built. DriftCheck runs against the deployed site and is itself tested against a deliberately broken one.

System
What a green build can hide
  1. Green build
    CI passes
  2. Live deployment
    Can still be broken
  3. DriftCheckCode
    Verifies the live deployment actually works
Deterministic codeLanguage model
Build
  • Published to npm as @shreekumar007/driftcheck
  • TypeScript and Node.js CLI
  • CI on GitHub Actions
  • A deliberately broken Vercel fixture used as a negative test
  • 91 passing tests
Challenges
  • Proving the tool fails when it should: the broken Vercel fixture exists so the negative case is tested, not assumed.
Result

Published on npm with CI and 91 passing tests.

Learnings

A verifier needs a negative test. Without a known-broken target, a pass means nothing.

Next project
Buy or Wait?
Agent / Claude Code