Skip to main content
Failpath is a flow monitoring tool that tracks every step of your backend workflows in real time. Instead of digging through logs after something goes wrong, you get a live view of each run on the Failpath dashboard — showing which steps succeeded, which failed, and which were skipped, along with the exact point of failure and any attached metadata.

​
How Failpath works

Failpath is built around two packages that work together. The CLI (failpath) manages flow graphs: you run npx failpath init once to connect your repository to a Failpath project, which writes your dashboard’s current flow definition to .failpath/flows.json. From there, npx failpath publish pushes local edits to the dashboard, and npx failpath sync pulls dashboard changes back into your repo. The SDK (@failpath/sdk) handles runtime instrumentation. You wrap your backend functions with createFailpathClient, then call run() to start a named flow run and step() around each logical unit of work. Every step() call fires a running event before the operation starts, then a success or error event when it finishes. If the wrapped function throws, the SDK records the error and rethrows the original exception so your application error handling stays intact. Together, the CLI defines what your flows look like and the SDK reports what actually happened during each execution.

​
Key concepts

  • Flows — A named sequence of steps that represents one logical backend process, such as checkout or send-invoice. Flows are defined in .failpath/flows.json and managed with the CLI.
  • Runs — A single execution of a flow, identified by a runId you supply (typically a request ID or job ID). Every step in the same request shares the same run.
  • Steps — The individual units of work within a run, each identified by a stepKey that matches the sdkStepKey in your flow definition.
  • Events — The status signals (running, success, error, skip) that the SDK sends to the Failpath API as each step executes.

Quick Start

Initialize Failpath, instrument your first function, and publish a flow in under five minutes.

CLI Reference

Full reference for the init, publish, and sync commands.

SDK Reference

Explore every option available in createFailpathClient, run(), and step().

Core Concepts

Dive deeper into flows, runs, steps, and how they map to your application code.