Migration

Upgrade guidance for major changes

0.1.x → 0.2.0+

0.2.0 rebuilt the library around zero dependencies, a shipped stylesheet, and React Server Components. Most component APIs are unchanged (legacy prop names such as isOpen/onClose still work), but four changes need action:

1. Import the stylesheet (required)

Snippet

// app/layout.tsx — once, at the app root
import '@creo-team/buzz-ui/styles.css'

Components no longer rely on your Tailwind configuration or hand-written CSS variables — the stylesheet ships every token for all six themes.

2. Toasts are built in

Snippet

- import toast, { Toaster } from 'react-hot-toast'
+ import { toast, Toaster } from '@creo-team/buzz-ui/client'

The call signatures you likely use (toast.success, toast.error, toast.promise, toast.dismiss) are compatible. HotToastProvider keeps working as an alias of Toaster.

3. ESM only

The package no longer ships CommonJS. Every modern bundler (Next.js, Vite, Remix) handles this automatically; CJS require() consumers must switch to import.

4. Framer Motion animation props are gone

AnimationPresets and Modal/Dropdown animationVariants were removed — animations are CSS now. Restyle them by overriding the bz-* classes and keyframes.

The full itemized list lives in the package's CHANGELOG.