Filter Builder

Filter Builder: Faceted stepped query filter builder with dynamic attribute selectors, operator dropdowns, AND/OR logic toggles, and animated chip tags. Free MIT React & Next.js source with Motion and Tailwind CSS, live preview, CLI install and docs.

Install Filter Builder

npx motion-ui-skill add filter-builder

Components install as source into your project. The interactive page also includes preview, code, documentation and install tabs.

Dependencies

  • clsx
  • lucide-react
  • motion
  • react
  • tailwind-merge

Source files

Filter Builder

Faceted stepped query filter builder with dynamic attribute selectors, operator dropdowns, AND/OR logic toggles, and animated chip tags. Inspired by KeenThemes ReUI and shadcn/ui.

Install

npx motion-ui-skill add filter-builder

Dependencies

  • clsx
  • lucide-react
  • motion
  • react
  • tailwind-merge

Usage

"use client";

import { FilterBuilder, type FilterField, type FilterRule } from "@/components/motion/filter-builder";
import { useState } from "react";

const FIELDS: FilterField[] = [
  {
    id: "status",
    label: "Status",
    type: "select",
    options: ["Active", "Pending", "Suspended", "Archived"],
  },
  {
    id: "role",
    label: "Team Role",
    type: "select",
    options: ["Admin", "Engineer", "Designer", "Auditor"],
  },
  {
    id: "email",
    label: "User Email",
    type: "text",
  },
  {
    id: "score",
    label: "Health Score",
    type: "number",
  },
];

const INITIAL_RULES: FilterRule[] = [
  {
    id: "r1",
    fieldId: "status",
    operator: "is",
    value: "Active",
  },
  {
    id: "r2",
    fieldId: "score",
    operator: ">",
    value: "80",
  },
];

export function FilterBuilderExample() {
  const [activeRules, setActiveRules] = useState<FilterRule[]>(INITIAL_RULES);

  return (
    <div className="max-w-xl p-4">
      <FilterBuilder
        fields={FIELDS}
        initialRules={INITIAL_RULES}
        conjunction="AND"
        onChange={(rules, conj) => {
          setActiveRules(rules);
          console.log("Updated filters:", rules, "Match:", conj);
        }}
      />
    </div>
  );
}

Props

Prop Type Default Description
fields FilterField[] required Available filterable attributes with type and option definitions.
initialRules FilterRule[] [] Initial set of applied filter rules.
conjunction "AND" | "OR" "AND" Boolean conjunction joining rules together.
onChange (rules: FilterRule[], conjunction: "AND" | "OR") => void undefined Callback emitted whenever rules or conjunction changes.
className string undefined Custom styling overrides merged via cn().

Browse this category