mberneti

mberneti / ts-modularity

Public

A CLI tool that scans TypeScript projects and visualizes module boundaries as interactive diagrams.

14
3
100% credibility
Found May 31, 2026 at 14 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
JavaScript
AI Summary

ts-modularity is a code analysis tool that scans your TypeScript project, builds a visual map of how all your files connect to each other, groups them into logical clusters, and scores how well-organized each cluster is. It serves an interactive visualization in your browser with five different views (chord diagram, force graph, DAG layout, coupling matrix, and move suggestions) so you can see at a glance which parts of your code are tightly coupled and might need reorganizing. The tool also suggests specific files that could be moved to better locations, complete with one-click commands you can copy and run.

How It Works

1
🔍 You notice your code is getting tangled

As your project grows, you suspect some files are in the wrong places, importing from unexpected spots.

2
⚡ You run one simple command

A single command scans all your TypeScript files and maps out every connection between them.

3
🎨 Your project comes alive in a browser

Colorful diagrams appear showing your code as interconnected clusters - you can finally see the structure.

4
You explore different views
🔄
Chord diagram

See arcs and ribbons showing how clusters connect to each other

🧲
Force graph

Watch clusters float and arrange themselves based on their relationships

📊
Coupling matrix

Spot problems at a glance with a heatmap showing which clusters depend on each other

5
📈 You check your modularity scores

Each cluster gets a score showing how self-contained it is - green means healthy, red means tangled.

6
💡 You get specific suggestions

The tool recommends which files should move to different clusters, with confidence ratings.

✨ You have a clear plan

Ready-to-use commands appear for moving files around - your refactoring path is crystal clear.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 14 to 14 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is ts-modularity?

A CLI tool that scans your TypeScript codebase and spits out interactive dependency visualizations. Point it at any directory, and it builds a graph showing how your modules import each other, calculates modularity scores for each cluster, and serves everything as a web dashboard at localhost. It handles path aliases from tsconfig.json and can work with explicit module boundaries you define in a config file.

Why is it gaining traction?

The key differentiator is the combination of static analysis plus actionable refactoring advice. Most dependency visualizers stop at pretty pictures—ts-modularity goes further by suggesting specific files to move and even generating the git mv commands to run. It also flags circular dependencies through a coupling matrix and supports five different views so you can pick the visualization that fits your mental model. Zero runtime dependencies means it installs fast and has no surprises.

Who should use this?

Developers maintaining TypeScript codebases with growing coupling problems. If you've inherited a tangled codebase or are planning to split a monolith, this gives you a clear picture of what's connected to what. Tech leads evaluating modularity of a new architecture will appreciate the quantified scores. The move suggestion feature is particularly useful for teams ready to do actual refactoring work.

Verdict

With only 14 stars and a 1.0% credibility score, this is an early-stage project that shows promise but lacks community validation. The feature set is solid for exploratory work, and the generated git commands make it practically useful. Try it on a side project before betting on it for critical work.

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.