Skip to main content

Rev-dep

High-speed dependency analysis and codebase governance for JavaScript and TypeScript projects

Why Rev-dep?

Rev-dep is a high-performance CLI tool designed to enforce architecture integrity and dependency hygiene across large-scale JavaScript and TypeScript projects. Built in Go for exceptional speed, it consolidates fragmented checks from multiple tools into a single, parallelized pass.

10x-200x Faster

Built in Go to eliminate Node.js performance bottlenecks. Audit 500k+ LoC in ~500ms.

Config-Based Governance

Execute multiple hygiene checks in one parallelized pass. Enforce module boundaries and import conventions.

Monorepo Native

First-class support for modern workspaces. Resolves package.json exports/imports maps and TypeScript aliases.

Exploratory Toolkit

Debug dependency issues with powerful CLI commands. Trace transitive relations and fix problems quickly.

Quick Start

1

Install Rev-dep

Install as a development dependency in your project:
npm install -D rev-dep
2

Initialize Configuration

Create a configuration file with sensible defaults:
npx rev-dep config init
3

Run Checks

Execute all configured checks:
npx rev-dep config run

Key Features

Circular Dependency Detection

Detect circular imports that can cause hard-to-debug issues

Unused Code Detection

Find orphan files and unused exports with autofix support

Module Boundaries

Enforce architecture rules between different parts of your codebase

Import Conventions

Standardize import styles with automatic fixes

Dependency Validation

Identify unused, missing, or duplicate node_modules

CI Integration

Fast enough to run on every commit without slowing down CI

Governance Capabilities

Rev-dep moves beyond passive scanning to active enforcement, answering critical questions:
  • Architecture Integrity: “Is my ‘Domain A’ illegally importing from ‘Domain B’?”
  • Dead Code & Bloat: “Are these files unreachable, or are these node_modules unused?”
  • Refactoring Safety: “Which entry points actually use this utility, and are there circular chains?”
  • Workspace Hygiene: “Are my imports consistent and are all dependencies declared?”

Explore the CLI Reference

Browse all available commands and their options

Performance Comparison

Rev-dep significantly outperforms alternatives:
TaskRev-depAlternativeSpeedup
Find circular dependencies289msdpdm-fast: 7,061ms24x faster
Find unused exports303msknip: 6,606ms22x faster
Find unused files277msknip: 6,596ms23x faster
Find unused node modules287msknip: 6,572ms22x faster
Discover entry points323msmadge: 67,000ms207x faster
Rev-dep can audit a 500k+ LoC project in approximately 500ms, making it practical to run on every commit.

Next Steps

Installation Guide

Learn how to install Rev-dep globally or locally

Quickstart Tutorial

Get up and running with your first checks

Configuration Guide

Set up config-based checks for your project

Monorepo Support

Learn how to use Rev-dep in monorepo projects

Build docs developers (and LLMs) love