Feature developement entry point

README.md

@@ -48,6 +48,10 @@ Developed with best practices for a maintainable and scalable codebase:
 *   **GoRouter:** Well-structured and powerful navigation.
 *   **Benefit for you:** An easy-to-understand, extendable, and testable foundation for your project. 📈
 
+#### ⚙️ **Flexible Environment Configuration**
+Easily switch between development (in-memory data or local API) and production environments with a simple code change. This empowers rapid prototyping, robust testing, and seamless deployment.
+*   **Benefit for you:** Accelerate your development cycle and ensure your app is always ready for any deployment scenario. 🚀
+
 #### 🌍 **Localization Ready**
 Fully internationalized with working English and Arabic localizations (`.arb` files). Adding more languages is straightforward.
 *   **Benefit for you:** Easily adapt your application for a global audience. 🌐

lib/account/bloc/account_bloc.dart

@@ -13,13 +13,14 @@ class AccountBloc extends Bloc<AccountEvent, AccountState> {
   AccountBloc({
     required HtAuthRepository authenticationRepository,
     required HtDataRepository<UserContentPreferences>
-        userContentPreferencesRepository,
-  })  : _authenticationRepository = authenticationRepository,
-        _userContentPreferencesRepository = userContentPreferencesRepository,
-        super(const AccountState()) {
+    userContentPreferencesRepository,
+  }) : _authenticationRepository = authenticationRepository,
+       _userContentPreferencesRepository = userContentPreferencesRepository,
+       super(const AccountState()) {
     // Listen to user changes from HtAuthRepository
-    _userSubscription =
-        _authenticationRepository.authStateChanges.listen((user) {
+    _userSubscription = _authenticationRepository.authStateChanges.listen((
+      user,
+    ) {
       add(AccountUserChanged(user));
     });
 
@@ -35,7 +36,7 @@ class AccountBloc extends Bloc<AccountEvent, AccountState> {
 
   final HtAuthRepository _authenticationRepository;
   final HtDataRepository<UserContentPreferences>
-      _userContentPreferencesRepository;
+  _userContentPreferencesRepository;
   late StreamSubscription<User?> _userSubscription;
 
   Future<void> _onAccountUserChanged(
@@ -47,7 +48,9 @@ class AccountBloc extends Bloc<AccountEvent, AccountState> {
       add(AccountLoadUserPreferences(userId: event.user!.id));
     } else {
       // Clear preferences if user is null (logged out)
-      emit(state.copyWith(clearPreferences: true, status: AccountStatus.initial));
+      emit(
+        state.copyWith(clearPreferences: true, status: AccountStatus.initial),
+      );
     }
   }
 
@@ -113,8 +116,9 @@ class AccountBloc extends Bloc<AccountEvent, AccountState> {
     emit(state.copyWith(status: AccountStatus.loading));
 
     final currentPrefs = state.preferences!;
-    final isCurrentlySaved =
-        currentPrefs.savedHeadlines.any((h) => h.id == event.headline.id);
+    final isCurrentlySaved = currentPrefs.savedHeadlines.any(
+      (h) => h.id == event.headline.id,
+    );
     final List<Headline> updatedSavedHeadlines;
 
     if (isCurrentlySaved) {
@@ -125,8 +129,9 @@ class AccountBloc extends Bloc<AccountEvent, AccountState> {
         ..add(event.headline);
     }
 
-    final updatedPrefs =
-        currentPrefs.copyWith(savedHeadlines: updatedSavedHeadlines);
+    final updatedPrefs = currentPrefs.copyWith(
+      savedHeadlines: updatedSavedHeadlines,
+    );
 
     try {
       await _userContentPreferencesRepository.update(
@@ -163,8 +168,9 @@ class AccountBloc extends Bloc<AccountEvent, AccountState> {
     emit(state.copyWith(status: AccountStatus.loading));
 
     final currentPrefs = state.preferences!;
-    final isCurrentlyFollowed = currentPrefs.followedCategories
-        .any((c) => c.id == event.category.id);
+    final isCurrentlyFollowed = currentPrefs.followedCategories.any(
+      (c) => c.id == event.category.id,
+    );
     final List<Category> updatedFollowedCategories;
 
     if (isCurrentlyFollowed) {
@@ -175,8 +181,9 @@ class AccountBloc extends Bloc<AccountEvent, AccountState> {
         ..add(event.category);
     }
 
-    final updatedPrefs =
-        currentPrefs.copyWith(followedCategories: updatedFollowedCategories);
+    final updatedPrefs = currentPrefs.copyWith(
+      followedCategories: updatedFollowedCategories,
+    );
 
     try {
       await _userContentPreferencesRepository.update(
@@ -213,8 +220,9 @@ class AccountBloc extends Bloc<AccountEvent, AccountState> {
     emit(state.copyWith(status: AccountStatus.loading));
 
     final currentPrefs = state.preferences!;
-    final isCurrentlyFollowed =
-        currentPrefs.followedSources.any((s) => s.id == event.source.id);
+    final isCurrentlyFollowed = currentPrefs.followedSources.any(
+      (s) => s.id == event.source.id,
+    );
     final List<Source> updatedFollowedSources;
 
     if (isCurrentlyFollowed) {
@@ -225,8 +233,9 @@ class AccountBloc extends Bloc<AccountEvent, AccountState> {
         ..add(event.source);
     }
 
-    final updatedPrefs =
-        currentPrefs.copyWith(followedSources: updatedFollowedSources);
+    final updatedPrefs = currentPrefs.copyWith(
+      followedSources: updatedFollowedSources,
+    );
 
     try {
       await _userContentPreferencesRepository.update(

lib/account/bloc/account_event.dart

@@ -7,15 +7,17 @@ abstract class AccountEvent extends Equatable {
   List<Object?> get props => [];
 }
 
-class AccountUserChanged extends AccountEvent { // Corrected name
+class AccountUserChanged extends AccountEvent {
+  // Corrected name
   const AccountUserChanged(this.user);
   final User? user;
 
   @override
   List<Object?> get props => [user];
 }
 
-class AccountLoadUserPreferences extends AccountEvent { // Corrected name
+class AccountLoadUserPreferences extends AccountEvent {
+  // Corrected name
   const AccountLoadUserPreferences({required this.userId});
   final String userId;
 

lib/account/bloc/account_state.dart

@@ -27,8 +27,7 @@ class AccountState extends Equatable {
     return AccountState(
       status: status ?? this.status,
       user: clearUser ? null : user ?? this.user,
-      preferences:
-          clearPreferences ? null : preferences ?? this.preferences,
+      preferences: clearPreferences ? null : preferences ?? this.preferences,
       errorMessage:
           clearErrorMessage ? null : errorMessage ?? this.errorMessage,
     );

lib/account/view/account_page.dart

@@ -35,12 +35,17 @@ class AccountPage extends StatelessWidget {
         ),
       ),
       body: ListView(
-        padding: const EdgeInsets.all(AppSpacing.paddingMedium), // Adjusted padding
+        padding: const EdgeInsets.all(
+          AppSpacing.paddingMedium,
+        ), // Adjusted padding
         children: [
           _buildUserHeader(context, user, isAnonymous),
           const SizedBox(height: AppSpacing.lg), // Adjusted spacing
           ListTile(
-            leading: Icon(Icons.tune_outlined, color: theme.colorScheme.primary),
+            leading: Icon(
+              Icons.tune_outlined,
+              color: theme.colorScheme.primary,
+            ),
             title: Text(
               l10n.accountContentPreferencesTile,
               style: textTheme.titleMedium,
@@ -50,9 +55,15 @@ class AccountPage extends StatelessWidget {
               context.goNamed(Routes.manageFollowedItemsName);
             },
           ),
-          const Divider(indent: AppSpacing.paddingMedium, endIndent: AppSpacing.paddingMedium),
+          const Divider(
+            indent: AppSpacing.paddingMedium,
+            endIndent: AppSpacing.paddingMedium,
+          ),
           ListTile(
-            leading: Icon(Icons.bookmark_outline, color: theme.colorScheme.primary),
+            leading: Icon(
+              Icons.bookmark_outline,
+              color: theme.colorScheme.primary,
+            ),
             title: Text(
               l10n.accountSavedHeadlinesTile,
               style: textTheme.titleMedium,
@@ -62,9 +73,15 @@ class AccountPage extends StatelessWidget {
               context.goNamed(Routes.accountSavedHeadlinesName);
             },
           ),
-          const Divider(indent: AppSpacing.paddingMedium, endIndent: AppSpacing.paddingMedium),
+          const Divider(
+            indent: AppSpacing.paddingMedium,
+            endIndent: AppSpacing.paddingMedium,
+          ),
           _buildSettingsTile(context),
-          const Divider(indent: AppSpacing.paddingMedium, endIndent: AppSpacing.paddingMedium),
+          const Divider(
+            indent: AppSpacing.paddingMedium,
+            endIndent: AppSpacing.paddingMedium,
+          ),
         ],
       ),
     );
@@ -89,12 +106,14 @@ class AccountPage extends StatelessWidget {
       displayName = l10n.accountAnonymousUser;
       statusWidget = Padding(
         padding: const EdgeInsets.only(top: AppSpacing.md), // Increased padding
-        child: ElevatedButton.icon( // Changed to ElevatedButton
+        child: ElevatedButton.icon(
+          // Changed to ElevatedButton
           icon: const Icon(Icons.link_outlined),
           label: Text(l10n.accountSignInPromptButton),
           style: ElevatedButton.styleFrom(
             padding: const EdgeInsets.symmetric(
-              horizontal: AppSpacing.lg, vertical: AppSpacing.sm,
+              horizontal: AppSpacing.lg,
+              vertical: AppSpacing.sm,
             ),
             textStyle: textTheme.labelLarge,
           ),
@@ -111,7 +130,8 @@ class AccountPage extends StatelessWidget {
       statusWidget = Column(
         mainAxisSize: MainAxisSize.min, // To keep column tight
         children: [
-          if (user?.role != null) ...[ // Show role only if available
+          if (user?.role != null) ...[
+            // Show role only if available
             const SizedBox(height: AppSpacing.xs),
             Text(
               l10n.accountRoleLabel(user!.role.name),
@@ -122,21 +142,23 @@ class AccountPage extends StatelessWidget {
             ),
           ],
           const SizedBox(height: AppSpacing.md), // Consistent spacing
-          OutlinedButton.icon( // Changed to OutlinedButton.icon
+          OutlinedButton.icon(
+            // Changed to OutlinedButton.icon
             icon: Icon(Icons.logout, color: colorScheme.error),
             label: Text(l10n.accountSignOutTile),
             style: OutlinedButton.styleFrom(
               foregroundColor: colorScheme.error,
               side: BorderSide(color: colorScheme.error.withOpacity(0.5)),
               padding: const EdgeInsets.symmetric(
-                horizontal: AppSpacing.lg, vertical: AppSpacing.sm,
+                horizontal: AppSpacing.lg,
+                vertical: AppSpacing.sm,
               ),
               textStyle: textTheme.labelLarge,
             ),
             onPressed: () {
-              context
-                  .read<AuthenticationBloc>()
-                  .add(const AuthenticationSignOutRequested());
+              context.read<AuthenticationBloc>().add(
+                const AuthenticationSignOutRequested(),
+              );
             },
           ),
         ],