WingoUI
Buttons & Actions
ButtonButton GroupCopy ButtonDelete ButtonTheme ToggleToggleToggle Group
Inputs
Avatar UploadCalendarCheckboxColor PickerComboboxCron PickerCurrency InputDate PickerDate Range PickerDate Time PickerDuration PickerFile UploadFilter BuilderInputInput GroupListboxMasked InputMention InputMonth PickerMulti SelectNumber InputOTP InputPassword InputPhone InputRadio GroupRatingSearch InputSegmented ControlSelectSignature PadSliderSwitchTag InputTextareaTime Picker
Forms
Address InputCSV ImportFieldForm WizardInline EditInvoice line itemsRich Text Editor
Navigation
Back To TopBounce SidebarBreadcrumbCommand MenuGlobal SearchGooey NavHook SidebarNav MenuNav TabsPaginationProximity SidebarScroll ProgressSidebarStepsTable Of ContentsTabsTopbarUser MenuWorkspace Switcher
Overlays
Alert DialogContext MenuDialogDrawerDropdown MenuFamily DrawerHover CardPopoverSheetShortcuts DialogTooltipTour
Feedback
AlertBannerCookie ConsentEmoji ReactionEmpty StateNotification BellNotification CenterProgressRoute ProgressSkeletonSpinnerToast
Data Display
Approval FlowAvatarBadgeCalendar ViewCode BlockComment ThreadContact cardCountdownDescription ListDiff ViewerFile ListFile managerFolderGanttJSON ViewerKbdLog ViewerMarkdownPresenceSchedulerTagTimelineTree View
Tables & Lists
Audit LogData TableDeal PipelineEditable GridKanbanListMembers tablePermissions MatrixTableTask ListVirtual List
Charts & Stats
Animated CounterArea chartBar chartDonut chartFunnel chartGaugeGitHub ActivityHeatmap calendarLeaderboardLine chartRadial barSparklineStat CardTrackerTrend badge
Layout
AccordionApp ShellCardCollapsibleDetail LayoutEntity HeaderPage HeaderScroll AreaSeparatorSettings LayoutSplit ViewToolbar
Media
Audio PlayerCarouselImage CropperImage LightboxLocation MapQR CodeStep PlayerVideo Player
AI Kit
Agent Status CardChat MessageChat ThreadConversation ListFluid OrbGrid RevealMatrix OrbModel PickerPrompt InputReasoning IndicatorRule BuilderSuggestion ChipsTool Call TimelineUsage MeterVoice InputWorkflow Canvas
Text & Effects
Gravity Letters
Mobile
Action SheetBottom Tab BarFABHaptic ButtonHero HeaderInstall PromptLarge Title HeaderNotification BannerOnboarding CarouselPicker WheelPull To RefreshSlide To ConfirmSticky CTA BarSwipe DeckSwipeable Tabs
Commerce
Cart drawerCategory pickerCheckout stepsCoupon inputFavorite buttonFilter panelListing cardListing gridOrder trackerPricePrice rangePricing tableProduct galleryQuantity stepperReviewsSeller card
Blocks
Admin Dashboard PageAdmin ShellAI Chat PageAutomation Builder PageCheckout PageCRM Contact PageCRM Pipeline PageError PagesInbox PageInvoice PageKPI DashboardListing Detail PageLogin PageMarketplace Home PageMarketplace Search PageMarketplace ShellMobile App HomeOnboarding FlowPost Listing WizardPricing PageRegister PageSettings PageUsers Admin Page
Hooks & Utilities
AI ChatChart kitCommerceDate utilsFile exportFile typesFiltersForm validationHapticsInvoicingMotion presetsNavigationNumber formatRelative timeRomanian locationsSpreadsheetText matchTonesUIProvideruseClipboarduseConsentuseControllableStateuseCooldownuseDebounceuseKeyboardInsetuseLocaleuseLongPressuseMediaControlsuseMediaQueryuseOverflowItemsusePersistedStateuseScrollEdgesuseScrollStateuseSelectionuseShortcutuseStickToBottom
GalleryThemeCredits

Inputs

Filter Builder

InputsFilter Builder
File UploadInput
Live props
Appearance
variant
size
radius
tone
Layout
maxChipsAll
responsive
State
defaultOpen
disabled
loading
defaultActiveViewId
Behavior
applyMode
allowOr
allowGroups
shortcut
locale
Content
resultCountFrom the table
Code
import { FilterBuilder } from "@/components/ui/filter-builder"

<FilterBuilder />
Pro

v1.0.0·Added in 1.0.0

Advanced filters for any list: condition chips, AND / OR, nested groups, saved views and a live count, with one bottom sheet on phones.

Press + Filter (or the shortcut, shift+F in the demo) for a searchable, grouped list of fields: type to narrow it, Up and Down to move, Enter to pick. The new chip appears with its editor open, the operator already chosen and focus in the value: text applies as you type (after a short pause) and on Enter, numbers and amounts through their fields, dates on an inline calendar with quick ranges, choices in a list with search, checkboxes and Select all. Close an editor (Escape, a click outside) while its condition is incomplete, or after emptying it, and the chip goes away, so no chip ever filters nothing. Click a chip to edit it; its × removes it. The chips row is a toolbar with one Tab stop: Left and Right move between chips, the and / or toggle, + Filter and Clear, Home and End jump to the ends, Enter or Space opens a chip, Delete or Backspace removes it and focus moves to the next chip. The and / or between the first two chips switches the whole filter. A nested group shows as one chip with its sentence and opens the panel, where every condition is a row (field, operator, value, remove): Add condition and Add group put focus in the new row, Enter in a text or number value applies at once (or applies the draft and closes with applyMode apply), and removing a row from the keyboard moves focus to the next one. The views menu lists saved views (pinned first) and All records, Up and Down move through them; changing a view's filter marks it modified and offers Save changes or Save as new view, with Rename and Delete in each view's ⋯ menu, and a save the app rejects keeps the name and says so. The result count updates in a polite live region. With applyMode apply, editors keep a draft until Apply. On a phone a Filters button with the count opens one bottom sheet: the conditions as rows with a ⋯ for Edit and Remove, and / or as a segmented control, + Add filter drills into the field list and then the editor with a short slide (long lists scroll under their search), the back arrow returns, focus lands on each page's title, and nothing changes until Show 24 results; closing the sheet discards the draft. The chips under it scroll sideways and their × removes at once.

Add to a project

npx wingo-ui@latest add filter-builder

Pro item: the CLI needs a Pro account. See plans

Dependencies

motionlucide-reactbadgebuttoncalendarcurrency-inputdate-pickerdate-range-pickerdrawerdropdown-menuinputlistboxnumber-inputpopoversegmented-controlselectspinnertooltipfiltersdate-utilsnumber-formatuse-controllable-stateuse-localeuse-media-queryuse-scroll-edgesuse-shortcutmotiontonesui-config

Files

  • components/ui/filter-builder.tsx

See also

FilterslibToolbarData TableListboxKPI Dashboard
PreviousFile UploadNext Input

Clients

Acme CRM
5 clients5 clients
Filtered clients
ClientCityStatusBalanceLast invoiceOwner
Tech Solutions Inc.12-3456789ChicagoActive$12,480.0009/18/2026Emma Carter
Summit Logistics23-4567891DenverActive$48,920.5009/22/2026Liam Walker
Construct Group56-7891234DallasActive$103,400.0009/20/2026Liam Walker
Dental Art Clinic78-9123456MiamiActive$5,600.0009/12/2026Emma Carter
Northwind Studio19-2837495ChicagoActive$9,870.0009/23/2026Ryan Brooks
  • Tech Solutions Inc.12-3456789

    Chicago

    Active
    Balance
    $12,480.00
    Last invoice
    09/18/2026
  • Summit Logistics23-4567891

    Denver

    Active
    Balance
    $48,920.50
    Last invoice
    09/22/2026
  • Construct Group56-7891234

    Dallas

    Active
    Balance
    $103,400.00
    Last invoice
    09/20/2026
  • Dental Art Clinic78-9123456

    Miami

    Active
    Balance
    $5,600.00
    Last invoice
    09/12/2026
  • Northwind Studio19-2837495

    Chicago

    Active
    Balance
    $9,870.00
    Last invoice
    09/23/2026
describeFilter
Status is Active and Balance ≥ $5,000
?filter=
WyJhIixbWyJzdGF0dXMiLCJpcyIsImFjdGl2ZSJdLFsiYmFsYW5jZSIsImd0ZSIsNTAwMF1dXQ
props
applyMode=instantresponsive=trueshortcut=shift+fmaxChips=0locale=en-USresultCount=tableactiveViewId=null

Press + Filter (or shift+f), pick a field, and the table follows. Saved views live in the All clients menu.Tap Filters: one sheet holds a draft until “Show … clients”. The × on a chip removes it at once.