Get an architecture health score and letter grade for a React or Next.js project.
Find circular dependencies, orphan modules, and oversized components before they cause problems.
Track architecture health over time by running Arcovia weekly or in CI.
Enforce custom module boundary rules with a project-specific policy file.
| gkhan205/arcovia | fberrez/quietdash.com | flaviojmendes/dinamos | |
|---|---|---|---|
| Stars | 43 | 43 | 43 |
| Language | TypeScript | TypeScript | TypeScript |
| Setup difficulty | easy | hard | moderate |
| Complexity | 2/5 | 4/5 | 3/5 |
| Audience | developer | vibe coder | developer |
Figures from each repo's GitHub metadata at analysis time.
Run directly with npx, no account or configuration required to get started.
Arcovia is a command line tool that looks at the architecture of a React or Next.js codebase and tells you how healthy it is. Instead of checking code style like a typical linter, it builds a map of how all your files depend on each other, checks that map against a set of architecture rules, and turns the results into a score, a letter grade, and an interactive HTML report you can open in a browser. You run it with a single command against the project you want to inspect, and it produces a report that highlights problems such as circular dependencies between files, orphaned modules nobody imports, duplicate imports, overly large components, and files that too many other files depend on. It groups these findings into categories like architecture, imports, components, complexity, hooks, performance, context, and routes, each weighted differently in the final score, and it points out which fixes would help the most, called hotspots and quick wins. Everything runs on your own computer. No source code is sent anywhere, no account is needed, and the tool does not collect any usage data. The scoring itself comes from static analysis rules rather than an AI model, so the same codebase produces the same score every time you run it. Arcovia also keeps a history of past reports, so if you run it regularly, such as weekly or as part of your CI pipeline, you can see a timeline showing whether your architecture is improving or getting worse over time. It currently supports React, Next.js, and Vite projects fully, with experimental support for Remix. Version 0.2.0 added the ability to write custom policy rules in a configuration file, so teams can enforce their own boundaries, like preventing UI code from importing server-only code, and have violations show up alongside the built-in findings.
A CLI tool that analyzes React and Next.js codebases and generates a scored, interactive architecture health report.
Mainly TypeScript. The stack also includes TypeScript, React, Next.js.
Setup difficulty is rated easy, with roughly 5min to a first successful run.
Mainly developer.
This repo across BitVibe Labs
double-check against the repo, no cap.