archlintWe don't fix your architecture. We stop it from getting worse.

Fast, AST-based architecture smell detector for TypeScript/JavaScript projects.

Get Started

View on GitHub

28+ Detectors

From circular dependencies to God modules and layer violations. Built with Rust and oxc for maximum performance.

Diff Mode

Philosophy of "ratchet, don't renovate". Lock current state and only fail on new architectural regressions.

Framework-Aware

Built-in presets for NestJS, Next.js, React, and oclif. Knows about your framework's architectural patterns.

Blazingly Fast

Analyzes 200+ files in under 5 seconds. Parallel processing and smart content-based caching.

Actionable Insights

Every report includes severity scores, clear explanations, and refactoring recommendations.

Integration Ready

ESLint plugin, GitHub Actions, GitLab CI, and even an MCP server for your AI coding assistant.

Why archlint?

Modern codebases grow complex fast. archlint helps you detect architectural problems early before they become technical debt.

bash

# Catch regressions in your PR
npx -y @archlinter/cli diff HEAD~1 --explain

🔴 REGRESSION: New cycle detected

  src/orders/service.ts → src/payments/processor.ts → src/orders/service.ts

  Why this is bad:
    Circular dependencies create tight coupling between modules.
    Changes in one module can cause unexpected failures in the other.

  How to fix:
    Extract shared logic into a separate module, or use dependency injection.