---

name: deps_npm router_kit: FullStackKit description: npm/yarn dependency management, package.json best practices ve version control. metadata: skillport: category: development tags: [architecture, automation, best practices, clean code, coding, collaboration, compliance, debugging, deps npm, design patterns, development, documentation, efficiency, git, optimization, productivity, programming, project management, quality assurance, refactoring, software engineering, standards, testing, utilities, version control, workflow] - deps-security

📦 Deps NPM

npm dependency management ve best practices.

---

📋 package.json Best Practices

Copy{
  "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

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

---

📊 Dependency Types

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

---

Deps NPM v1.1 - Enhanced

🔄 Workflow

Kaynak: NPM Security Best Practices

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ı