Merge pull request #161 from flutter-news-app-full-source-code/feat-filter-bookmarks

Feat filter bookmarks

Author: fulleni

CHANGELOG.md

@@ -1,43 +1,50 @@
 # Changelog
 
-## 1.3.0
-
-- feat: enforce content following and bookmarking limits ([#145](link), [#159](link))
-- feat: enforce mandatory app updates via remote configuration ([#134](link))
-- refactor: separate authentication and account linking flows ([#142](link))
-- refactor: use `flutter_native_splash` for web splash screen management ([#137](link))
-- refactor: implement centralized logging for GoRouter navigation ([#143](link))
-- fix: web splash screen remains visible indefinitely ([#136](link))
-- fix: back button is unresponsive during authentication flow ([#144](link))
-- fix: ensure proper redirection after successful authentication ([#148](link))
-- fix: content limitation bottom sheet overflows on small screens ([#149](link))
-- chore(deps): update bloc, go_router, and other key dependencies ([#135](link))
-- docs: clarify feed display settings in README ([#150](link))
+## 1.4.0 - 2025-10-14
+
+- **feat**: implement saved feed filters with create, rename, and delete
+- **feat**: add horizontal filter bar to the headlines feed for quick selection
+- **refactor**: replace monolithic "apply followed items" with granular controls
+- **refactor**:  Updated the Headline Details page with a fading scroll effect for metadata chips and a new style for the 'Continue Reading' button. The main feed's filter icon was removed from the AppBar in favor of the new filter bar.
+
+## 1.3.0 - 2025-10-10
+
+- **feat**: enforce content following and bookmarking limits
+- **feat**: enforce mandatory app updates via remote configuration
+- **refactor**: separate authentication and account linking flows
+- **refactor**: use `flutter_native_splash` for web splash screen management
+- **refactor**: implement centralized logging for GoRouter navigation
+- **fix**: web splash screen remains visible indefinitely
+- **fix**: back button is unresponsive during authentication flow
+- **fix**: ensure proper redirection after successful authentication
+- **fix**: content limitation bottom sheet overflows on small screens
+- **chore(deps)**: update bloc, go_router, and other key dependencies
+- **docs**: clarify feed display settings in README
 
 ## 1.2.1
 
--   **Fix:** Resolved an issue where the web splash screen would not disappear after the application loaded due to an incorrect bootstrap script in `index.html`.
+- **fix**: resolved an issue where the web splash screen would not disappear after the application loaded due to an incorrect bootstrap script in `index.html`.
 
 ## 1.2.0
 
--   **Refactor:** Updated `flutter_launcher_icons` configurations.
--   **Refactor:** Updated `flutter_native_splash` configurations.
--   **Dependency Update:** Bumped `bloc` to `^9.0.1`.
--   **Dependency Update:** Bumped `flutter_bloc` to `^9.1.1`.
--   **Dependency Update:** Bumped `go_router` to `^16.2.4`.
--   **Dependency Update:** Bumped `google_fonts` to `^6.3.2`.
--   **Dependency Update:** Bumped `share_plus` to `^11.1.0`.
--   **Dependency Update:** Bumped `very_good_analysis` to `^10.0.0`.
--   **Metadata Update:** Updated `homepage` and `documentation` URLs.
--   **Metadata Update:** Added `funding` link.
--   **Metadata Update:** Added `flutter` and `flutter-full-app` to `topics`.
--   **Metadata Update:** Added `screenshots` configuration.
+- **refactor**: updated `flutter_launcher_icons` configurations
+- **refactor**: updated `flutter_native_splash` configurations
+- **chore(deps)**: bumped `bloc` to `^9.0.1`
+- **chore(deps)**: bumped `flutter_bloc` to `^9.1.1`
+- **chore(deps)**: bumped `go_router` to `^16.2.4`
+- **chore(deps)**: bumped `google_fonts` to `^6.3.2`
+- **chore(deps)**: bumped `share_plus` to `^11.1.0`
+- **chore(deps)**: bumped `very_good_analysis` to `^10.0.0`
+- **docs**: updated `homepage` and `documentation` URLs
+- **docs**: added `funding` link
+- **docs**: added `flutter` and `flutter-full-app` to `topics`
+- **docs**: added `screenshots` configuration
 
 ## 1.1.0
 
--   **Feature:** Implemented app version enforcement based on remote configuration, including a dedicated `UpdateRequiredPage` to guide users to update.
--   **Enhancement:** Integrated `package_info_plus` and `pub_semver` for accurate version retrieval and comparison across platforms (Android, iOS, Web).
+- **feat**: implemented app version enforcement based on remote configuration, including a dedicated `UpdateRequiredPage` to guide users to update
+- **feat**: integrated `package_info_plus` and `pub_semver` for accurate version retrieval and comparison across platforms (Android, iOS, Web)
 
 ## 1.0.1
 
--   **Version Control:** Transitioned from date-based versioning to semantic versioning. This release marks the first version following the semantic versioning standard.
+- **chore**: transitioned from date-based versioning to semantic versioning. This release marks the first version following the semantic versioning standard

README.md

@@ -36,6 +36,7 @@ Click on any category to explore.
 ### 🔍 Advanced Content Filtering & Search
 - **Comprehensive Filtering:** Let users filter headlines by `Topic`, `Source`, and `Country` using a dedicated filter interface.
 - **"Followed Items" Filter:** Users can instantly filter the feed to show only content from their followed topics, sources, and countries.
+- **Saved & Quick-Access Filters:** Empower users to save complex filter combinations and recall them with a single tap from a new, persistent filter bar on the main feed.
 - **Unified Search:** Includes a dedicated search page to help users find specific content quickly, with the ability to search across headlines, topics, sources, and countries.
 > **🎯 Your Advantage:** Give your users powerful content discovery tools that keep them engaged and coming back for more.
 

lib/app/bloc/app_bloc.dart

@@ -78,6 +78,9 @@ class AppBloc extends Bloc<AppEvent, AppState> {
     on<AppVersionCheckRequested>(_onAppVersionCheckRequested);
     on<AppUserFeedDecoratorShown>(_onAppUserFeedDecoratorShown);
     on<AppUserContentPreferencesChanged>(_onAppUserContentPreferencesChanged);
+    on<SavedFilterAdded>(_onSavedFilterAdded);
+    on<SavedFilterUpdated>(_onSavedFilterUpdated);
+    on<SavedFilterDeleted>(_onSavedFilterDeleted);
     on<AppLogoutRequested>(_onLogoutRequested);
 
     // Subscribe to the authentication repository's authStateChanges stream.
@@ -802,4 +805,105 @@ class AppBloc extends Bloc<AppEvent, AppState> {
       );
     }
   }
+
+  /// Handles adding a new saved filter to the user's content preferences.
+  ///
+  /// This method optimistically updates the state by dispatching an
+  /// [AppUserContentPreferencesChanged] event, which will then handle
+  /// persistence.
+  Future<void> _onSavedFilterAdded(
+    SavedFilterAdded event,
+    Emitter<AppState> emit,
+  ) async {
+    if (state.userContentPreferences == null) {
+      _logger.warning(
+        '[AppBloc] Skipping SavedFilterAdded: UserContentPreferences not loaded.',
+      );
+      return;
+    }
+
+    final updatedSavedFilters = List<SavedFilter>.from(
+      state.userContentPreferences!.savedFilters,
+    )..add(event.filter);
+
+    final updatedPreferences = state.userContentPreferences!.copyWith(
+      savedFilters: updatedSavedFilters,
+    );
+
+    add(AppUserContentPreferencesChanged(preferences: updatedPreferences));
+  }
+
+  /// Handles updating an existing saved filter (e.g., renaming it).
+  ///
+  /// This method finds the filter by its ID, replaces it with the updated
+  /// version, and then dispatches an [AppUserContentPreferencesChanged] event
+  /// to persist the changes.
+  Future<void> _onSavedFilterUpdated(
+    SavedFilterUpdated event,
+    Emitter<AppState> emit,
+  ) async {
+    if (state.userContentPreferences == null) {
+      _logger.warning(
+        '[AppBloc] Skipping SavedFilterUpdated: UserContentPreferences not loaded.',
+      );
+      return;
+    }
+
+    final originalFilters = state.userContentPreferences!.savedFilters;
+    final index = originalFilters.indexWhere((f) => f.id == event.filter.id);
+
+    if (index == -1) {
+      _logger.warning(
+        '[AppBloc] Skipping SavedFilterUpdated: Filter with id ${event.filter.id} not found.',
+      );
+      return;
+    }
+
+    final updatedSavedFilters = List<SavedFilter>.from(originalFilters)
+      ..[index] = event.filter;
+
+    final updatedPreferences = state.userContentPreferences!.copyWith(
+      savedFilters: updatedSavedFilters,
+    );
+
+    add(AppUserContentPreferencesChanged(preferences: updatedPreferences));
+  }
+
+  /// Handles deleting a saved filter from the user's content preferences.
+  ///
+  /// This method removes the filter by its ID and then dispatches an
+  /// [AppUserContentPreferencesChanged] event to persist the changes.
+  Future<void> _onSavedFilterDeleted(
+    SavedFilterDeleted event,
+    Emitter<AppState> emit,
+  ) async {
+    if (state.userContentPreferences == null) {
+      _logger.warning(
+        '[AppBloc] Skipping SavedFilterDeleted: UserContentPreferences not loaded.',
+      );
+      return;
+    }
+
+    final updatedSavedFilters = List<SavedFilter>.from(
+      state.userContentPreferences!.savedFilters,
+    )..removeWhere((f) => f.id == event.filterId);
+
+    // Check if the list was actually modified to avoid unnecessary updates.
+    if (updatedSavedFilters.length ==
+        state.userContentPreferences!.savedFilters.length) {
+      if (updatedSavedFilters.length ==
+          state.userContentPreferences!.savedFilters.length) {
+        _logger.warning(
+          '[AppBloc] Skipping SavedFilterDeleted: Filter with id ${event.filterId} not found.',
+        );
+        return;
+      }
+    }
+
+    final updatedPreferences = state.userContentPreferences!.copyWith(
+      savedFilters: updatedSavedFilters,
+    );
+
+    add(AppUserContentPreferencesChanged(preferences: updatedPreferences));
+  }
 }

lib/app/bloc/app_event.dart

@@ -156,3 +156,45 @@ class AppUserFeedDecoratorShown extends AppEvent {
   @override
   List<Object> get props => [userId, feedDecoratorType, isCompleted];
 }
+
+/// {@template saved_filter_added}
+/// Dispatched when a new feed filter is saved by the user.
+/// {@endtemplate}
+class SavedFilterAdded extends AppEvent {
+  /// {@macro saved_filter_added}
+  const SavedFilterAdded({required this.filter});
+
+  /// The new [SavedFilter] to be added.
+  final SavedFilter filter;
+
+  @override
+  List<Object> get props => [filter];
+}
+
+/// {@template saved_filter_updated}
+/// Dispatched when an existing saved feed filter is updated (e.g., renamed).
+/// {@endtemplate}
+class SavedFilterUpdated extends AppEvent {
+  /// {@macro saved_filter_updated}
+  const SavedFilterUpdated({required this.filter});
+
+  /// The updated [SavedFilter] object.
+  final SavedFilter filter;
+
+  @override
+  List<Object> get props => [filter];
+}
+
+/// {@template saved_filter_deleted}
+/// Dispatched when a saved feed filter is deleted by the user.
+/// {@endtemplate}
+class SavedFilterDeleted extends AppEvent {
+  /// {@macro saved_filter_deleted}
+  const SavedFilterDeleted({required this.filterId});
+
+  /// The ID of the filter to be deleted.
+  final String filterId;
+
+  @override
+  List<Object> get props => [filterId];
+}

lib/app/services/demo_data_initializer_service.dart

@@ -118,6 +118,7 @@ class DemoDataInitializerService {
         followedSources: const [],
         followedTopics: const [],
         savedHeadlines: const [],
+        savedFilters: const [],
       );
       await _userContentPreferencesRepository.create(
         item: defaultPreferences,