feat: Integrate shared preferences for storing recently searched profiles in ExplorePage

ios/Podfile.lock

···
     - FlutterMacOS
   - share_plus (0.0.1):
     - Flutter
+  - shared_preferences_foundation (0.0.1):
+    - Flutter
+    - FlutterMacOS
   - sqflite_darwin (0.0.4):
     - Flutter
     - FlutterMacOS
···
   - package_info_plus (from `.symlinks/plugins/package_info_plus/ios`)
   - path_provider_foundation (from `.symlinks/plugins/path_provider_foundation/darwin`)
   - share_plus (from `.symlinks/plugins/share_plus/ios`)
+  - shared_preferences_foundation (from `.symlinks/plugins/shared_preferences_foundation/darwin`)
   - sqflite_darwin (from `.symlinks/plugins/sqflite_darwin/darwin`)
   - url_launcher_ios (from `.symlinks/plugins/url_launcher_ios/ios`)
 
···
     :path: ".symlinks/plugins/path_provider_foundation/darwin"
   share_plus:
     :path: ".symlinks/plugins/share_plus/ios"
+  shared_preferences_foundation:
+    :path: ".symlinks/plugins/shared_preferences_foundation/darwin"
   sqflite_darwin:
     :path: ".symlinks/plugins/sqflite_darwin/darwin"
   url_launcher_ios:
···
   package_info_plus: c0502532a26c7662a62a356cebe2692ec5fe4ec4
   path_provider_foundation: 2b6b4c569c0fb62ec74538f866245ac84301af46
   share_plus: 8b6f8b3447e494cca5317c8c3073de39b3600d1f
+  shared_preferences_foundation: fcdcbc04712aee1108ac7fda236f363274528f78
   sqflite_darwin: 5a7236e3b501866c1c9befc6771dfd73ffb8702d
   url_launcher_ios: 5334b05cef931de560670eeae103fd3e431ac3fe
 

lib/screens/explore_page.dart

···
 import 'dart:async';
 
 import 'package:flutter/material.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
 import 'package:grain/api.dart';
 import 'package:grain/app_icons.dart';
 import 'package:grain/models/profile.dart';
+import 'package:grain/providers/profile_provider.dart';
 import 'package:grain/widgets/app_image.dart';
 import 'package:grain/widgets/plain_text_field.dart';
+import 'package:shared_preferences/shared_preferences.dart';
 
 import 'profile_page.dart';
 
-class ExplorePage extends StatefulWidget {
+class ExplorePage extends ConsumerStatefulWidget {
   const ExplorePage({super.key});
 
   @override
-  State<ExplorePage> createState() => _ExplorePageState();
+  ConsumerState<ExplorePage> createState() => _ExplorePageState();
 }
 
-class _ExplorePageState extends State<ExplorePage> {
+class _ExplorePageState extends ConsumerState<ExplorePage> {
   final TextEditingController _controller = TextEditingController();
   List<Profile> _results = [];
+  List<Profile> _recentlySearched = [];
+  static const String _recentlySearchedKey = 'recently_searched_dids';
   bool _loading = false;
   bool _searched = false;
   Timer? _debounce;
···
   @override
   void initState() {
     super.initState();
+    _loadRecentlySearched();
+  }
+
+  Future<void> _loadRecentlySearched() async {
+    final prefs = await SharedPreferences.getInstance();
+    final dids = prefs.getStringList(_recentlySearchedKey) ?? [];
+    if (dids.isNotEmpty) {
+      final profiles = <Profile>[];
+      for (final did in dids) {
+        try {
+          final asyncProfile = ref.watch(profileNotifierProvider(did));
+          if (asyncProfile.hasValue && asyncProfile.value != null) {
+            profiles.add(asyncProfile.value!.profile);
+          } else {
+            final profileWithGalleries = await ref.refresh(profileNotifierProvider(did).future);
+            if (profileWithGalleries != null) {
+              profiles.add(profileWithGalleries.profile);
+            }
+          }
+        } catch (_) {}
+      }
+      if (mounted) {
+        setState(() {
+          _recentlySearched = profiles;
+        });
+      }
+    }
+  }
+
+  Future<void> _saveRecentlySearched() async {
+    final prefs = await SharedPreferences.getInstance();
+    final dids = _recentlySearched.map((p) => p.did).toList();
+    await prefs.setStringList(_recentlySearchedKey, dids);
   }
 
   void _onSearchChanged(String value) {
···
                 : null,
           ),
         ),
+        if (_controller.text.isEmpty && _recentlySearched.isNotEmpty)
+          Padding(
+            padding: const EdgeInsets.symmetric(horizontal: 8.0, vertical: 4),
+            child: Column(
+              crossAxisAlignment: CrossAxisAlignment.start,
+              children: [
+                Padding(
+                  padding: const EdgeInsets.only(left: 4.0, bottom: 4.0),
+                  child: Text(
+                    'Recent Searches',
+                    style: theme.textTheme.titleSmall?.copyWith(
+                      fontWeight: FontWeight.bold,
+                      color: theme.textTheme.bodyMedium?.color,
+                    ),
+                  ),
+                ),
+                SizedBox(
+                  height: 96,
+                  child: ListView.separated(
+                    scrollDirection: Axis.horizontal,
+                    itemCount: _recentlySearched.length,
+                    separatorBuilder: (context, index) => SizedBox(width: 16),
+                    itemBuilder: (context, index) {
+                      final profile = _recentlySearched[index];
+                      return SizedBox(
+                        width: 80,
+                        child: Stack(
+                          children: [
+                            SizedBox(
+                              width: 80,
+                              height: 96,
+                              child: Column(
+                                mainAxisAlignment: MainAxisAlignment.center,
+                                children: [
+                                  Expanded(
+                                    child: GestureDetector(
+                                      onTap: () async {
+                                        FocusScope.of(context).unfocus();
+                                        _debounce?.cancel();
+                                        setState(() {
+                                          _searched = false;
+                                          _loading = false;
+                                        });
+                                        if (context.mounted) {
+                                          Navigator.of(context).push(
+                                            MaterialPageRoute(
+                                              builder: (context) =>
+                                                  ProfilePage(did: profile.did, showAppBar: true),
+                                            ),
+                                          );
+                                        }
+                                      },
+                                      child: CircleAvatar(
+                                        radius: 32,
+                                        backgroundColor: theme.colorScheme.surfaceContainerHighest,
+                                        backgroundImage: profile.avatar?.isNotEmpty == true
+                                            ? NetworkImage(profile.avatar!)
+                                            : null,
+                                        child: profile.avatar?.isNotEmpty == true
+                                            ? null
+                                            : Icon(
+                                                AppIcons.accountCircle,
+                                                color: theme.iconTheme.color,
+                                                size: 40,
+                                              ),
+                                      ),
+                                    ),
+                                  ),
+                                  SizedBox(height: 4),
+                                  SizedBox(
+                                    width: 80,
+                                    child: Text(
+                                      profile.displayName?.isNotEmpty == true
+                                          ? profile.displayName!
+                                          : '@${profile.handle}',
+                                      style: theme.textTheme.bodyMedium,
+                                      maxLines: 1,
+                                      overflow: TextOverflow.ellipsis,
+                                      textAlign: TextAlign.center,
+                                    ),
+                                  ),
+                                ],
+                              ),
+                            ),
+                            Positioned(
+                              top: 4,
+                              right: 4,
+                              child: GestureDetector(
+                                onTap: () async {
+                                  setState(() {
+                                    _recentlySearched.removeAt(index);
+                                  });
+                                  await _saveRecentlySearched();
+                                },
+                                child: Container(
+                                  padding: const EdgeInsets.all(2),
+                                  decoration: BoxDecoration(
+                                    color: theme.colorScheme.surface,
+                                    shape: BoxShape.circle,
+                                    boxShadow: [BoxShadow(color: Colors.black26, blurRadius: 2)],
+                                  ),
+                                  child: Icon(Icons.close, size: 18, color: theme.iconTheme.color),
+                                ),
+                              ),
+                            ),
+                          ],
+                        ),
+                      );
+                    },
+                  ),
+                ),
+              ],
+            ),
+          ),
         if (_controller.text.isNotEmpty)
           Padding(
             padding: const EdgeInsets.symmetric(horizontal: 16.0, vertical: 4),
···
             setState(() {
               _searched = false;
               _loading = false;
+              // Move to front if already present, else add to front
+              final existingIndex = _recentlySearched.indexWhere((p) => p.did == profile.did);
+              if (existingIndex != -1) {
+                _recentlySearched.removeAt(existingIndex);
+              }
+              _recentlySearched.insert(0, profile);
+              // Limit to 10 recent users
+              if (_recentlySearched.length > 10) {
+                _recentlySearched.removeLast();
+              }
             });
+            await _saveRecentlySearched();
             if (context.mounted) {
               Navigator.of(context).push(
                 MaterialPageRoute(

macos/Flutter/GeneratedPluginRegistrant.swift

···
 import package_info_plus
 import path_provider_foundation
 import share_plus
+import shared_preferences_foundation
 import sqflite_darwin
 import url_launcher_macos
 import window_to_front
···
   FPPPackageInfoPlusPlugin.register(with: registry.registrar(forPlugin: "FPPPackageInfoPlusPlugin"))
   PathProviderPlugin.register(with: registry.registrar(forPlugin: "PathProviderPlugin"))
   SharePlusMacosPlugin.register(with: registry.registrar(forPlugin: "SharePlusMacosPlugin"))
+  SharedPreferencesPlugin.register(with: registry.registrar(forPlugin: "SharedPreferencesPlugin"))
   SqflitePlugin.register(with: registry.registrar(forPlugin: "SqflitePlugin"))
   UrlLauncherPlugin.register(with: registry.registrar(forPlugin: "UrlLauncherPlugin"))
   WindowToFrontPlugin.register(with: registry.registrar(forPlugin: "WindowToFrontPlugin"))

pubspec.lock

···
       url: "https://pub.dev"
     source: hosted
     version: "6.0.0"
+  shared_preferences:
+    dependency: "direct main"
+    description:
+      name: shared_preferences
+      sha256: "6e8bf70b7fef813df4e9a36f658ac46d107db4b4cfe1048b477d4e453a8159f5"
+      url: "https://pub.dev"
+    source: hosted
+    version: "2.5.3"
+  shared_preferences_android:
+    dependency: transitive
+    description:
+      name: shared_preferences_android
+      sha256: "20cbd561f743a342c76c151d6ddb93a9ce6005751e7aa458baad3858bfbfb6ac"
+      url: "https://pub.dev"
+    source: hosted
+    version: "2.4.10"
+  shared_preferences_foundation:
+    dependency: transitive
+    description:
+      name: shared_preferences_foundation
+      sha256: "6a52cfcdaeac77cad8c97b539ff688ccfc458c007b4db12be584fbe5c0e49e03"
+      url: "https://pub.dev"
+    source: hosted
+    version: "2.5.4"
+  shared_preferences_linux:
+    dependency: transitive
+    description:
+      name: shared_preferences_linux
+      sha256: "580abfd40f415611503cae30adf626e6656dfb2f0cee8f465ece7b6defb40f2f"
+      url: "https://pub.dev"
+    source: hosted
+    version: "2.4.1"
+  shared_preferences_platform_interface:
+    dependency: transitive
+    description:
+      name: shared_preferences_platform_interface
+      sha256: "57cbf196c486bc2cf1f02b85784932c6094376284b3ad5779d1b1c6c6a816b80"
+      url: "https://pub.dev"
+    source: hosted
+    version: "2.4.1"
+  shared_preferences_web:
+    dependency: transitive
+    description:
+      name: shared_preferences_web
+      sha256: c49bd060261c9a3f0ff445892695d6212ff603ef3115edbb448509d407600019
+      url: "https://pub.dev"
+    source: hosted
+    version: "2.4.3"
+  shared_preferences_windows:
+    dependency: transitive
+    description:
+      name: shared_preferences_windows
+      sha256: "94ef0f72b2d71bc3e700e025db3710911bd51a71cefb65cc609dd0d9a982e3c1"
+      url: "https://pub.dev"
+    source: hosted
+    version: "2.4.1"
   shelf:
     dependency: transitive
     description:

pubspec.yaml

···
   url_launcher: ^6.3.1
   reorderables: ^0.6.0
   exif: ^3.3.0
+  shared_preferences: ^2.5.3
 
 dependency_overrides:
   analyzer: 7.3.0