🚀 DevScope — Understanding Your Codebase Dependencies Like Never Before

In large projects, dependencies grow quickly.

Because of reusable components, shared utilities, and modular architecture, it becomes hard to answer a simple question:

👉 “If I change this file, what else will it affect?”

I faced this problem multiple times while working on real projects.
So I decided to build something to solve it.

That’s how DevScope was born.

🧩 The Problem

As projects scale:

Files become interconnected
Imports grow complex
Refactoring becomes risky

Even a small change can break multiple parts of the application—and you may not even realize it.

💡 The Solution

DevScope is a lightweight CLI tool that:

Builds a dependency graph of your project
Tracks relationships between files
Identifies impacted files instantly
⚡ Getting Started

Install globally:

npm install -g @maheshdev/dev-scope

Run inside your project:

dev-scope analyze

This generates a clean dependency tree:

src/index.ts
  ├── src/commands/overview.ts
  ├── src/commands/impact.ts
  └── src/commands/analyze.ts

🔍 Impact Analysis

Want to know what breaks if you change a file?
dev-scope impact <file_name>

dev-scope impact src/graph/buildGraph.ts

Output:

Affected:
  ├── src/commands/analyze.ts
  ├── src/index.ts
  ├── src/commands/impact.ts
  └── src/commands/overview.ts

This is extremely useful before refactoring.

📊 Project Insights

You can also run:

dev-scope overview

This gives insights like:

Total files & dependencies
Leaf files (no dependencies)
Most used files
Unused files

🧠 How It Works (Simplified)

At its core, DevScope uses two main ideas:

1. Dependency Graph

Each file is treated as a node.
Imports between files create edges.

Example:

A → B → C

This means:

A depends on B
B depends on C

1. Reverse Traversal (DFS)

To find impacted files:

Start from the changed file
Traverse backwards through dependencies
Collect all files that depend on it

This is done using Depth First Search (DFS).

🎯 Why I Built This

While working on projects, I often struggled with:

Understanding large codebases quickly
Safe refactoring
Identifying unused files

I wanted something:

Simple
Fast
No UI overhead
Just works in terminal
⚙️ Tech Stack
TypeScript
Node.js
Commander (CLI)
🚀 Try It Yourself
npm install -g @maheshdev/dev-scope

Start exploring your codebase:

dev-scope analyze
dev-scope impact
🔮 What’s Next

I’m planning to improve:

More language support
Better visualization
Performance optimizations
🤝 Feedback

This is just the beginning.
If you try it, I’d love to hear your thoughts!