🛡️ DevArchitect — Engineering Intelligence & Architectural Guardrails
Understand your codebase. Prevent architectural drift. Engineer with confidence.
DevArchitect brings deterministic architectural intelligence, real-time change blast radius analysis, and boundary enforcement directly into Visual Studio Code and Cursor.
⚡ Key Features
1. 🛡️ Live Architecture Health Score
- Always visible in your status bar:
$(shield) Health: 94/100 (A).
- Evaluates 6 deterministic dimensions: Architecture Compliance, Cyclomatic Complexity, Module Coupling, Code Duplication, Maintainability (LOC), and Testing Coverage.
- Click the status bar item to run an instant deep analysis.
2. 📊 In-Editor Architecture Studio
- Explore your interactive architecture graph directly inside a VS Code editor tab without launching external browsers or servers.
- Filter by layer (Components, Services, Hooks, Routes, Utilities).
- Click any node to visualize its downstream callers (blast radius), inspect outgoing dependencies, and jump directly to the source file with 1 click.
3. 💥 Real-Time Change Blast Radius
- Inline CodeLens: Displays downstream callers above exported components and functions (
💥 Blast Radius: 8 downstream files).
- Sidebar Blast Radius Tree: Lists all downstream files importing your active editor file with one-click navigation.
- Automatically refreshes on tab change and file save.
4. 📁 Monorepo & Subfolder Auto-Detection
- Works effortlessly with root workspaces, monorepos (
pnpm, Turborepo, npm, yarn), and nested project folders (e.g. apps/*, packages/*, client/, server/).
- 1-click Scope Switcher: Switch target project folders anytime via the view title button or command palette.
5. 🚨 Policy Violations & Instant Code Jumps
- Expand the Policy Violations tree to view architectural violations (Clean Architecture layers, Feature-Sliced Design, circular dependency traps).
- Click any violation to jump immediately to the exact offending line in your code.
🚀 Quick Start
- Install DevArchitect from the Visual Studio Marketplace or Open VSX Registry (Cursor).
- Open any TypeScript or JavaScript workspace.
- Click the DevArchitect Shield icon in the Activity Bar to view your Code Health and Active File Blast Radius.
- Click the graph icon (
📊) in the sidebar header to open the Interactive Architecture Studio!
⌨️ Command Palette
All features are accessible via Ctrl+Shift+P (Windows/Linux) or Cmd+Shift+P (macOS):
| Command |
Action |
DevArchitect: Open Architecture Graph in Editor |
Opens visual architecture studio webview in an editor tab |
DevArchitect: Refresh Architecture Health |
Runs codebase health evaluation and updates scores |
DevArchitect: Refresh Active File Blast Radius |
Updates blast radius callers for active file |
DevArchitect: Select Target Project Folder |
Switch target folder in monorepos and nested workspaces |
DevArchitect: Inspect File Blast Radius |
Shows quick notifications of downstream callers |
DevArchitect: Validate Architecture Rules |
Runs rule evaluation in terminal |
DevArchitect: Audit Environment Variables & Secrets |
Scans for missing env keys and secret leaks |
DevArchitect: Run Safe Fixer (Dry Run) |
Safe auto-fixer for unused types and logs |
🖥️ Companion CLI
Need CI/CD enforcement, Git pre-commit & pre-push guardrails, or headless terminal analysis?
DevArchitect comes with a fast CLI companion package published to npm:
# Run instantly with npx (zero installation)
npx devarchitect-cli health
npx devarchitect-cli studio
npx devarchitect-cli validate
# Or install globally
npm install -g devarchitect-cli
Explore the CLI documentation on npm and GitHub.
⚙️ Configuration
DevArchitect works out of the box with zero configuration. To customize architecture presets, layers, and rules, create .devarchitect/config.json:
{
"$schema": "https://devarchitect.dev/schema/config.json",
"architecture": {
"preset": "recommended",
"rules": {
"no-circular-dependencies": "error",
"no-cross-feature-imports": "error",
"enforce-public-api": "warning",
"max-dependency-depth": "warning"
}
}
}
