2024년 10월 14일자로 Zustand v5가 출시되었습니다. 핵심 변경사항들만 정리해보았습니다.

• 번들 사이즈가 절반 이상으로 줄었습니다. (1.2kb -> 588b)

  • As-is (v4)

    • Minified: 3.1kb

    • Minified + Gzip 압축: 1.2kb

  • To-be (v5)

    • Minified: 1.2kb

    • Minified + Gzip 압축: 588b

• React 최소 요구 버전이 React 18 버전으로 변경되었습니다.

• TypeScript 최소 요구 버전이 4.5 버전으로 변경되었습니다.

• use-sync-external-store 패키지가 피어 디펜던시로 변경되었습니다.

  • zustand/traditional의 createWithEqualityFn과 useStoreWithEqualityFn을 사용하고 계셨다면 use-sync-external-store 패키지를 별도로 설치하셔야 합니다.

• ES5 지원이 중단되었습니다.

  • Vite를 사용하시는 분들은 vite.config.ts 파일에서 build.target 옵션을 es2015 이상으로 설정하셨는지 확인해 주세요.

  • TypeScript 설정도 확인해 주세요. tsconfig.json 파일의 compilerOptions에서 target을 ES6 이상으로 설정해야 합니다.

v4 -> v5로 올리시는 분들은 아래 마이그레이션 가이드 링크를 참고해 주세요.

https://github.com/pmndrs/zustand/blob/main/docs/migrations/migrating-to-v5.md