# Deps NPM

> 📦 Deps NPM

- Skill: `vuralserhat86/deps-npm` (Agent Skill)
- Install (CLI): `npx skillmds@latest add vuralserhat86/deps-npm`
- Raw SKILL.md: https://api.skillmd.com/api/skills/vuralserhat86/deps-npm/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: vuralserhat86 (https://skillmd.com/u/vuralserhat86)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/vuralserhat86/deps-npm

---


# 📦 Deps NPM

> npm dependency management ve best practices.

---

## 📋 package.json Best Practices

```json
{
  "name": "my-app",
  "version": "1.0.0",
  "engines": { "node": ">=20.0.0" },
  "scripts": {
    "dev": "vite",
    "build": "tsc && vite build",
    "lint": "eslint .",
    "test": "vitest"
  }
}
```

---

## 🔒 Version Control

| Prefix | Anlamı | Örnek |
|--------|--------|-------|
| `^1.2.3` | Minor updates OK | 1.x.x |
| `~1.2.3` | Patch only | 1.2.x |
| `1.2.3` | Exact version | 1.2.3 |

```bash
# Lock file ZORUNLU
npm ci  # package-lock.json kullan
```

---

## 📊 Dependency Types

```json
{
  "dependencies": {},      // Production
  "devDependencies": {},   // Development only
  "peerDependencies": {}   // Consumer provides
}
```

---

*Deps NPM v1.1 - Enhanced*

## 🔄 Workflow

> **Kaynak:** [NPM Security Best Practices](https://docs.npmjs.com/creating-and-publishing-scoped-public-packages)

### Aşama 1: Audit & Analysis
- [ ] **Lockfile**: `package-lock.json` var ve güncel mi?
- [ ] **Security**: `npm audit` çalıştır ve kritik açıkları gider.
- [ ] **Licenses**: Production bağımlılıklarının lisanslarını kontrol et.

### Aşama 2: Update Strategy
- [ ] **Minor/Patch**: `npm outdated` ile güvenli güncellemeleri yap.
- [ ] **Major**: Breaking change'leri release note'lardan oku ve tek tek güncelle.
- [ ] **Clean**: Kullanılmayan paketleri `depcheck` ile bul ve sil.

### Aşama 3: CI/CD Protection
- [ ] **Immutable**: CI'da mutlaka `npm ci` kullan (asla `npm install` değil).
- [ ] **Vulnerability**: Pipeline'a audit step ekle (`npm audit --audit-level=high`).

### Kontrol Noktaları
| Aşama | Doğrulama |
|-------|-----------|
| 1 | `node_modules` silinip `npm ci` yapılınca proje çalışıyor mu? |
| 2 | Production build, `devDependencies` olmadan çalışıyor mu? |
| 3 | Tüm versiyonlar 'Exact' veya 'Tilde/Caret' stratejisine uygun mu? |