gkhan205/arcovia

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.