archradar

O que é

ArchRadar é uma CLI open source que analisa a arquitetura de projetos frontend e entrega um diagnóstico técnico com:

• score de saúde arquitetural
• detecção de risco
• análise de complexidade
• acoplamento entre módulos
• dependências circulares
• saúde das dependências
• recomendações práticas de refatoração

Sem setup.
Sem config.
Sem firula.

Você roda.
Ele escaneia.
Você entende o que está torto.

📐 Antes de avaliar os números: leia DESIGN.md — o que archradar mede, o que não mede, e por que a matemática é honesta. Para as fórmulas exatas, veja SCORING.md. Se você é dev sênior revisando a tool, comece por esses dois.

O que ele faz

1. Detecta seu stack

Identifica automaticamente o framework e o contexto do projeto:

• React
• Next.js
• Vite
• Vue
• Angular
• Svelte

2. Mede saúde arquitetural

Gera um Architectural Health Score de 0 a 100 com base em sinais reais da estrutura do projeto.

3. Analisa complexidade

Usa AST para identificar arquivos e módulos com alta complexidade ciclomática.

4. Mapeia acoplamento

Mostra onde seu projeto está excessivamente conectado e mais difícil de manter.

5. Detecta dependências circulares

Encontra ciclos entre arquivos e módulos que tendem a gerar bugs, confusão e dívida técnica.

6. Avalia dependências

Verifica bibliotecas:

• desatualizadas
• não utilizadas
• potencialmente arriscadas

7. Gera recomendações acionáveis

Nada de "seu projeto está ruim" e sumir. Ele aponta o que corrigir primeiro.

Output

╭──────────────────────────────────────────╮
│  ARCHRADAR — Architectural Intelligence  │
│  by Few Company                          │
╰──────────────────────────────────────────╯

  Project:   meu-app
  Framework: Next.js 14
  Files:     312
  Avg lines: 98
  Total deps: 48

  ─────────────────────────────────────────
  ARCHITECTURAL HEALTH SCORE
  ─────────────────────────────────────────

  ██████████░░░░░░░░░░  52/100  [C]

  Risk Level: HIGH
  Intervention needed. Accumulated technical debt.

  ─────────────────────────────────────────
  FINDINGS
  ─────────────────────────────────────────

  ⚠  12 critical file(s) (>300 lines)
  ✓  No circular dependencies
  ⚠  High complexity: SignupForm (score 122)
  ⚠  4 file(s) with high coupling (>15 imports)

  ─────────────────────────────────────────
  RECOMMENDATIONS
  ─────────────────────────────────────────

  1. 12 file(s) above 300 lines. Consider splitting into smaller modules.
  2. High cyclomatic complexity in "SignupForm". Extract smaller functions.
  3. Reduce inter-module dependencies in coupling hotspots.

  ─────────────────────────────────────────
  Deep analysis: fewcompany.com/radar
  ─────────────────────────────────────────

Instalação

npm install -g @fewcompany/archradar

Ou rode sem instalar:

npx @fewcompany/archradar

Uso

Rode dentro de qualquer projeto frontend:

archradar

Comandos

archradar scan           # Scan arquitetural completo (offline, grátis)
archradar scan --json    # Saída em JSON (para CI/pipelines)
archradar audit          # Audit profundo com markdown report (requer login)
archradar login          # Autenticação via GitHub
archradar whoami         # Mostra usuário logado
archradar logout         # Remove token local
archradar --version      # Versão
archradar --help         # Ajuda

Scan vs Audit

| | scan | audit | |---|---|---| | Custo | Grátis, sempre | Free durante early access | | Requer login | Não | Sim (GitHub OAuth) | | Funciona offline | Sim | Precisa de conexão com a API | | Output | Terminal (score + breakdown + findings) | Markdown report (.archradar/audit-YYYY-MM-DD.md) | | Inclui | Score, breakdown, complexity hotspots, recommendations | Tudo do scan + trends, benchmarks, fan-in/fan-out, cross-correlation, god components, barrels, bundle impact, dependency intelligence |

Requisitos

• Node.js >= 20.0.0

Comunidade

archradar é mantido pelos Few Soldiers, uma comunidade aberta de desenvolvedores. Eles estão trabalhando num motor de análise mais enxuto pro pacote premium do archradar — a API atual já entrega tudo o que prometemos, e o trabalho da comunidade refina e expande daqui pra frente.

English Summary

archradar is a free CLI tool that scans your frontend project's architecture and gives you a health score from 0 to 100 with actionable recommendations.

npx @fewcompany/archradar

What it does:

• Detects your framework and stack (React, Next.js, Angular, Vue, Svelte)
• Analyzes cyclomatic complexity via AST
• Maps circular dependencies
• Measures coupling density between modules
• Checks dependency health (outdated, unused, high-risk)
• Scores your architecture 0–100 with specific recommendations

No config needed. Just run it.

Built with TypeScript + ts-morph · License: AGPL-3.0 · by Few Company