es-toolkit: 사내 소형 라이브러리에서 글로벌 프로젝트로

토스 프론트엔드 팀이 사내 공유 유틸리티 라이브러리를 발전시켜 만든 es-toolkit이 주간 npm 다운로드 2,000만 건을 넘기며 글로벌 오픈소스 프로젝트로 자리 잡은 과정을 다룬다. lodash의 구조적 한계를 넘어 현대 웹 개발 환경에 최적화된 유틸리티 라이브러리를 처음부터 설계한 경험을 정리한다.

핵심 포인트

lodash는 IE 등 레거시 브라우저용 방어 로직과 ESM 미지원으로 트리쉐이킹이 불가능해 번들 최적화에 걸림돌이 됐다
es-toolkit은 네이티브 브라우저 함수를 적극 활용해 lodash 대비 최대 10배 빠른 실행 속도와 최대 30배 작은 번들 크기를 달성했다
기존 lodash 사용자의 전환 장벽을 낮추기 위해 lodash API와 호환되는 중간 레이어 es-toolkit/compat을 제공했다
Reddit r/javascript 포스팅 이후 수만 명의 개발자 관심을 받았고, Yarn, Recharts, Storybook, Mermaid 등 주요 오픈소스에 채택됐다
현재 주간 npm 다운로드 2,000만 건을 초과했으며 Node.js, Deno, Bun 서버 사이드 유틸리티로 확장 중이다

상세 정리

배경: 토스 팀은 throttle, debounce, uniq 같은 유틸리티가 필요했지만 사내 공유 라이브러리(@toss/utils) 유지보수 부담이 컸고, lodash는 레거시 로직과 ESM 미지원 문제가 있었다
lodash 한계: 오래된 코드 구조로 내장 브라우저 함수를 활용하지 않고 직접 구현, IE 대응 방어 로직으로 불필요한 코드가 많아 트리쉐이킹이 제대로 동작하지 않았다
설계 방향: 최신 ECMAScript 표준과 네이티브 브라우저 API를 전제로 처음부터 재설계, 레거시 호환 코드를 일절 배제했다
성능: throttle, debounce, uniq 등 핵심 함수에서 lodash 대비 최소 2배, 경우에 따라 10배 이상 빠른 실행 속도 달성
번들 크기: 불필요한 레거시 코드 제거로 일부 함수에서 30배 이상 번들 크기 축소
호환 레이어: es-toolkit/compat을 도입해 lodash 인터페이스를 유지하면서 내부 구현을 교체 — 기존 코드베이스를 최소 변경으로 마이그레이션 가능
커뮤니티 반응: Reddit 공유 후 100개 이상 업보트, 수만 명 유입 — 예상 밖의 관심으로 외부 기여자가 합류하기 시작
채택 사례: Yarn, Recharts, Storybook, Mermaid 등 메이저 오픈소스 프로젝트가 의존성으로 채택
현재 규모: 주간 npm 다운로드 2,000만 건 돌파, 엔터프라이즈 서비스와 오픈소스 전반에 확산
향후 계획: 서버 사이드(Node.js, Deno, Bun) 유틸리티로 범위 확장 중