Skip to content

fix(docs): README 의 패키지 매니저를 yarn → npm 으로 통일#27

Merged
seongyeon1 merged 1 commit intomainfrom
fix/issue-25-npm-conventions
May 1, 2026
Merged

fix(docs): README 의 패키지 매니저를 yarn → npm 으로 통일#27
seongyeon1 merged 1 commit intomainfrom
fix/issue-25-npm-conventions

Conversation

@seongyeon1
Copy link
Copy Markdown
Collaborator

Closes #25

문제

repo 는 `package-lock.json` 만 추적하는데 README 가 yarn 명령어로 안내. yarn 으로 설치하면 transitive dependency (특히 webpack) 가 달라져 dev server 가 `ProgressPlugin ValidationError` 로 종료됨.

```

  • yarn 환경: webpack@5.106.2 → webpackbar@6.0.1 와 충돌 → 시작 실패
  • npm 환경(package-lock.json): webpack@5.105.4 → 정상 동작
    ```

수정

이슈 추천 옵션 1 (npm 기준 정리). 가장 작은 변경.

변경 전 변경 후
`yarn` `npm ci`
`yarn start` `npm start`
`yarn build` `npm run build`
`yarn deploy` `npm run deploy`

추가로 README 상단에 "이 저장소는 npm 을 표준 패키지 매니저로 사용합니다" 안내를 명시해서 향후 다른 분이 yarn 으로 들어오는 케이스를 차단.

Test plan

  • `npm ci` 후 `npm start` 정상 동작 확인
  • `npm run build` 정상 동작 확인

repo 는 package-lock.json 만 추적하는데 README 가 yarn 을 안내해서, yarn 으로
설치할 경우 transitive dependency (특히 webpack) 가 달라져 dev server 가
ProgressPlugin ValidationError 로 종료되던 문제.

* yarn → npm ci (Installation)
* yarn start → npm start
* yarn build → npm run build
* yarn deploy → npm run deploy
* npm 표준 매니저 안내 줄 추가
@seongyeon1 seongyeon1 requested a review from ash-hun as a code owner May 1, 2026 02:25
@seongyeon1 seongyeon1 self-assigned this May 1, 2026
@seongyeon1 seongyeon1 merged commit 1c55c9a into main May 1, 2026
@seongyeon1 seongyeon1 deleted the fix/issue-25-npm-conventions branch May 1, 2026 02:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

로컬 실행 가이드와 lockfile 불일치로 yarn start 실패

1 participant