typescript-circular-dependency

What problem does it solve?

Circular dependencies cause runtime initialization issues in TypeScript/JavaScript projects when modules import each other in a cycle. Even if compile succeeds, one import may evaluate to undefined or throw a runtime error due to incomplete initialization.

Core Features & Use Cases

• Static analysis to detect circular dependencies across TS/JS modules.
• Dependency graph visualization to reveal cycle paths.
• Practical resolution guidance: extract shared interfaces, apply dependency injection, or refactor barrel patterns.
• Use cases include large codebases with interdependent services, monorepos, or libraries with circular imports.

Quick Start

Install madge and run: npm install -D madge npx madge --circular --extensions ts,tsx src/