README.md

AdminForth Universal Search Plugin

Lightweight plugin adding one debounced search input to the List view (injection point: beforeActionButtons). It builds a single OR filter across configured columns.

Features

• Add one debounced search input to AdminForth list views.
• Search across configured columns with a single query.
• Help teams find records faster in large back offices.
• Keep cross-column discovery close to the list screen.

Documentation

Full setup and configuration guide:

AdminForth Universal Filters Documentation

About AdminForth

AdminForth is an open-source, agent-first admin framework for building robust admin panels and back-office applications faster.

Related links

• AdminForth website
• npm package
• More AdminForth plugins
• Built by DevForth

Install

npm install @adminforth/universal-search

Usage

import UniversalFiltersPlugin from '@adminforth/universal-search';

plugins: [
  new UniversalFiltersPlugin({
    columns: [
      { name: 'title' },
      { name: 'description' },
      { name: 'country', caseSensitive: true },
      { name: 'price', exact: true },
    ],
    debounceMs: 400,
  })
]

Full docs & advanced options: see AdminForth docs (Plugins -> Universal Filters).

License

MIT