app_wide_search library

A high-performance Flutter package for app-wide search with grouped results.

This library provides a complete search solution with:

• Customizable SearchDelegate and full-screen search interfaces
• Grouped results with ExpansionTile widgets
• Offline caching and search history with Hive
• State management with Riverpod
• Deep-link support with go_router
• Internationalization with intl

Usage

First, initialize Hive and register adapters:

import 'package:hive_flutter/hive_flutter.dart';
import 'package:app_wide_search/app_wide_search.dart';

void main() async {
  await Hive.initFlutter();
  Hive.registerAdapter(SearchItemAdapter());
  Hive.registerAdapter(SearchGroupAdapter());
  Hive.registerAdapter(SearchHistoryItemAdapter());
  runApp(const MyApp());
}

Then, provide your search implementation:

ProviderScope(
  overrides: [
    searchProviderProvider.overrideWithValue(
      InMemorySearchProvider(mySearchableItems),
    ),
  ],
  child: MyApp(),
)

Show the search interface:

// Using SearchDelegate
final result = await showSearch(
  context: context,
  delegate: AppWideSearchDelegate(ref: ref),
);

// Or navigate to full-screen search
context.goToSearch();