How I Built an Architecture Scoring Model for React

Arcovia is a CLI tool that analyzes React, Next.js, and Vite codebases and produces a deterministic architecture score using static analysis — no AI, no network connection required. The author describes the motivation (replacing gut-feel architectural reviews with a reproducible number), the multi-layered scoring model (weighted category deductions, diminishing penalties for repeated findings, capped critical-risk adjustments), and the engineering challenges involved: making the dependency graph framework-aware to avoid false positives from Next.js conventions, and distinguishing harmless circular imports from genuinely dangerous ones at scale. GPT Codex was used for implementation velocity during OpenAI Build Week, while all scoring and architectural decisions remained with the author. The tool is open source under MIT, published on npm, and generates an HTML report plus a versioned JSON artifact that can track architecture health over time in CI.