# DepFixer

> Smart dependency analysis and migration tool for JavaScript & TypeScript projects

DepFixer is a developer tool that detects dependency conflicts, peer dependency mismatches, deprecated packages, and provides framework-aware migration recommendations. It analyzes package.json files against 5M+ real compatibility records — not AI guesses.

## What DepFixer Does

- **Conflict Detection**: Finds peer dependency conflicts, version mismatches, and incompatible packages
- **Migration Analysis**: Provides step-by-step migration paths for Angular (12→18), React (16→19), and Vue
- **Framework-Aware**: Understands framework-specific requirements (TypeScript compatibility, RxJS versions, etc.)
- **Health Scoring**: Rates your dependency health with actionable recommendations
- **Automated Fixes**: Generates a corrected package.json with resolved conflicts
- **CI/CD Integration**: GitHub Action for automated PR dependency checks with health scores
- **AI IDE Integration**: MCP Server brings dependency analysis into Claude Code, Cursor, and Windsurf

## Who It's For

- Frontend developers upgrading React or Angular projects
- Teams maintaining large JavaScript/TypeScript codebases
- DevOps engineers validating dependency health in CI/CD pipelines
- AI-assisted developers using Claude Code, Cursor, or Windsurf
- Developers tired of debugging "npm ERR! ERESOLVE unable to resolve dependency tree"

## How It Works

1. Upload or paste your package.json (CLI, web dashboard, GitHub Action, or MCP Server)
2. DepFixer analyzes dependencies against 5M+ compatibility records in real-time
3. Get a detailed report: conflicts found, severity levels, exact fix versions
4. Apply fixes automatically or review the corrected package.json

## Install (CLI)

```
npm install -g depfixer
```

Or run directly:

```
npx depfixer analyze
```

## Key Commands

- `depfixer analyze` — Scan project for dependency conflicts
- `depfixer migrate angular` — Get Angular migration plan
- `depfixer migrate react` — Get React migration plan
- `depfixer fix` — Apply recommended fixes automatically

## MCP Server (AI IDE Integration)

The DepFixer MCP Server brings dependency analysis directly into your AI coding assistant via the Model Context Protocol.

**Install:**
```
npx @depfixer/mcp-server
```

**Supported IDEs:**
- Claude Code (via `.claude/settings.json`)
- Cursor (via `.cursor/mcp.json`)
- Windsurf (via Windsurf MCP config)

**Available Tools:**
- `depfixer_analyze` — Scan package.json for conflicts and health issues
- `depfixer_check_compatibility` — Check if a package version works with your framework
- `depfixer_migrate` — Plan framework migrations with before/after health projections

**Setup (Claude Code example):**
```json
{
  "mcpServers": {
    "depfixer": {
      "command": "npx",
      "args": ["@depfixer/mcp-server"],
      "env": {
        "DEPFIXER_API_KEY": "dfx_live_YOUR_KEY"
      }
    }
  }
}
```

Works in free audit mode (no API key) or full mode (with API key for fix commands and migration planning).

## GitHub Action (CI/CD Integration)

Automatically check dependencies on every pull request. DepFixer posts a PR comment with health score, conflicts found, and fix commands.

**Quick Setup:**
```yaml
name: Dependency Check
on: [pull_request]

jobs:
  depfixer:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: depfixer/action@v1
        with:
          api-key: ${{ secrets.DEPFIXER_API_KEY }}
```

**Configuration Options:**
- `api-key` — Your DepFixer API key (required)
- `fail-on-conflicts` — Fail the check if conflicts are found (default: true)
- `package-json-path` — Path to package.json (default: ./package.json)
- `min-health-score` — Minimum health score to pass (default: 0)
- `post-comment` — Post results as PR comment (default: true)

**Usage Limits:**
- Free: 50 runs/month
- Pro: 500 runs/month
- Enterprise: Unlimited

## Supported Frameworks

- React (16, 17, 18, 19)
- Angular (12, 13, 14, 15, 16, 17, 18, 19)
- Vue (2, 3)
- Next.js, NestJS, Node.js

## Compatibility Database

Full compatibility database (700+ package-framework reports, auto-updated hourly):
- [/llms-full.txt](https://depfixer.com/llms-full.txt)

## Links

- [Website](https://depfixer.com)
- [Documentation](https://docs.depfixer.com)
- [CLI Reference](https://docs.depfixer.com/cli/overview)
- [MCP Server Setup Guide](https://docs.depfixer.com/guides/mcp-setup)
- [GitHub Action Guide](https://docs.depfixer.com/guides/github-action)
- [Angular Migration Guide](https://docs.depfixer.com/guides/angular-migration)
- [React Upgrade Guide](https://docs.depfixer.com/guides/react-upgrade)
- [npm CLI Package](https://www.npmjs.com/package/depfixer)
- [npm MCP Server Package](https://www.npmjs.com/package/@depfixer/mcp-server)
- [GitHub](https://github.com/depfixer/CLI)
- [Pricing](https://depfixer.com/pricing)

## Comparison

| Feature | DepFixer | npm audit | depcheck | Renovate |
|---------|----------|-----------|----------|----------|
| Peer dependency conflicts | Yes | No | No | No |
| Framework-aware analysis | Yes | No | No | No |
| Migration recommendations | Yes | No | No | No |
| Real-time compatibility data | Yes (5M+ records) | Limited | No | Limited |
| Fix generation | Yes | Partial | No | Yes (updates only) |
| CI/CD integration (GitHub Action) | Yes (PR comments + health score) | Yes | Yes | Yes |
| AI IDE integration (MCP Server) | Yes (Claude Code, Cursor, Windsurf) | No | No | No |
| Health scoring | Yes (0-100 score) | No | No | No |