Gooey Menu

A tactile liquid dropdown menu with organic SVG metaball fusion filter and spring-driven extrusion animation.

Installation

Add the component directly to your repository using shadcn CLI:

npx shadcn@latest add Surajmaurya1/easyui/gooey-menu

API Reference

PropTypeDefaultDescription
optionsstring[]['Home', 'About', 'Projects', 'Contact', 'Book a call', 'Follow us']Array of option labels
valuestringundefinedControlled active selected option
defaultValuestringoptions[0]Default selected option if uncontrolled
openbooleanundefinedControlled open dropdown state
defaultOpenbooleanfalseInitial open dropdown state if uncontrolled
onOpenChange(open: boolean) => voidundefinedCallback fired when open state changes
onSelect(option: string, index: number) => voidundefinedCallback fired on option selection
widthnumber306Pixel width of the dropdown panel and default pill; custom triggers keep their own size
triggerReactNodeundefinedOptional non-interactive content inside the trigger button, such as an avatar. Do not pass a nested button or link.
triggerLabelstring"Toggle menu" for custom triggersAccessible name for the trigger and its options
triggerClassNamestringundefinedClasses for the trigger button, including dimensions and border radius
triggerStyleCSSPropertiesundefinedInline trigger styles; size and corner radii are measured automatically
align"start" | "center" | "end""start"Logical alignment of the panel relative to the trigger. Start and end follow the inherited text direction.
optionClassNamestring | ((option: string, index: number) => string | undefined)undefinedAdditional classes for all options or individual actions, such as a red logout option
classNamestringundefinedCustom CSS class overrides