📦npm 기술 문서

npm 이 무엇인지, 레지스트리는 어떻게 작동하는지, 패키지와 모듈의 차이는 무엇인지 — 시니어가 갖는 근본적인 이해를 심는다.

package.json 의 모든 주요 필드를 해부한다. private, engines, exports, sideEffects, browserslist — Next.js 시니어가 반드시 알아야 할 설정을 전부 다룬다.

^, ~, *, 정확한 버전... 버전 범위 기호들이 실제로 허용하는 범위를 완벽하게 이해한다. 신입이 가장 많이 틀리는 SemVer 함정들을 집중 해부한다.

의존성 4종류를 완벽하게 구분한다. Next.js 맥락에서 어떤 패키지가 어디 들어가야 하는지, peerDependencies 가 왜 존재하는지, overrides 로 충돌을 해결하는 법까지 다룬다.

npm install 의 내부 동작, package-lock.json 의 구조와 역할, node_modules 호이스팅 원리, npm ci 가 필요한 이유를 완벽히 이해한다.

npm scripts 의 pre/post 훅, 라이프사이클 전체 지도, cross-env, husky & lint-staged 로 팀 개발 자동화를 완성하는 방법을 다룬다.

Next.js 14 App Router 프로젝트의 package.json 을 처음부터 설계한다. 의존성 분류 근거, Turbopack, .nvmrc, Docker 최적화, 모노레포 workspace 기초까지 다룬다.

npm audit의 동작 원리부터 CI 자동화, 토큰 관리, 공급망 공격 방어까지 — 시니어가 당연히 알아야 하는 npm 보안의 모든 것