git404hub

what is arcovia fr?

gkhan205/arcovia — explained in plain English

Analysis updated 2026-05-18

43TypeScriptAudience · developerComplexity · 2/5Setup · easy

tl;dr

A CLI tool that analyzes React and Next.js codebases and generates a scored, interactive architecture health report.

vibe map

mindmap
  root((Arcovia))
    What it does
      Builds dependency graph
      Scores architecture health
      Generates HTML report
    Tech stack
      TypeScript
      React
      Next.js
      Vite
    Use cases
      Find circular deps
      Track score over time
      Enforce policy rules
    Audience
      Frontend engineers
      Tech leads
      Engineering managers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Get an architecture health score and letter grade for a React or Next.js project.

VIBE 2

Find circular dependencies, orphan modules, and oversized components before they cause problems.

VIBE 3

Track architecture health over time by running Arcovia weekly or in CI.

VIBE 4

Enforce custom module boundary rules with a project-specific policy file.

what's the stack?

TypeScriptReactNext.jsVite

how it stacks up fr

gkhan205/arcoviafberrez/quietdash.comflaviojmendes/dinamos
Stars434343
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasyhardmoderate
Complexity2/54/53/5
Audiencedevelopervibe coderdeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min

Run directly with npx, no account or configuration required to get started.

in plain english

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.

prompts (copy fr)

prompt 1
Run arcovia analyze on my project and explain the biggest hotspots in the report.
prompt 2
Help me write a .arcovia.json policy rule that stops UI modules from importing server code.
prompt 3
Explain how Arcovia calculates its architecture score and grade.
prompt 4
Show me how to set up Arcovia in CI so I get a weekly architecture timeline.

Frequently asked questions

what is arcovia fr?

A CLI tool that analyzes React and Next.js codebases and generates a scored, interactive architecture health report.

What language is arcovia written in?

Mainly TypeScript. The stack also includes TypeScript, React, Next.js.

How hard is arcovia to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is arcovia for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.