Updated and added comments

Reviewed-on: #166
Reviewed-by: gelbeinhalb <spam@yannick-weigert.de>

lib/core/adaptive_page_route.dart

@@ -1,7 +1,11 @@
 import 'dart:io';
+
 import 'package:flutter/cupertino.dart';
 import 'package:flutter/material.dart';
 
+/// Returns a platform-adaptive page route based on the current platform.
+/// - On iOS, it returns a [CupertinoPageRoute].
+/// - On other platforms, it returns a [MaterialPageRoute].
 Route<T> adaptivePageRoute<T>({
   required Widget Function(BuildContext) builder,
   bool fullscreenDialog = false,

lib/core/constants.dart

@@ -1,3 +1,4 @@
+/// Application-wide constants
 class Constants {
   Constants._(); // Private constructor to prevent instantiation
 

lib/core/custom_theme.dart

@@ -1,5 +1,6 @@
 import 'package:flutter/material.dart';
 
+/// Theme class that defines colors, border radius, padding, and decorations
 class CustomTheme {
   CustomTheme._(); // Private constructor to prevent instantiation
 

lib/l10n/arb/app_de.arb

@@ -20,11 +20,7 @@
   "days_ago": "vor {count} Tagen",
   "delete": "Löschen",
   "delete_all_data": "Alle Daten löschen",
-  "delete_group": "Diese Gruppe löschen",
-  "edit_group": "Gruppe bearbeiten",
   "error_creating_group": "Fehler beim Erstellen der Gruppe, bitte erneut versuchen",
-  "error_deleting_group": "Fehler beim Löschen der Gruppe, bitte erneut versuchen",
-  "error_editing_group": "Fehler beim Bearbeiten der Gruppe, bitte erneut versuchen",
   "error_reading_file": "Fehler beim Lesen der Datei",
   "export_canceled": "Export abgebrochen",
   "export_data": "Daten exportieren",

lib/l10n/arb/app_en.arb

@@ -34,10 +34,10 @@
     "description": "Button text to create a match"
   },
   "@create_new_group": {
-    "description": "Appbar text to create a new group"
+    "description": "Button text to create a new group"
   },
   "@create_new_match": {
-    "description": "Appbar text to create a new match"
+    "description": "Button text to create a new match"
   },
   "@data": {
     "description": "Data label"
@@ -65,21 +65,9 @@
   "@delete_all_data": {
     "description": "Confirmation dialog for deleting all data"
   },
-  "@delete_group": {
-    "description": "Confirmation dialog for deleting a group"
-  },
-  "@edit_group": {
-      "description": "Button & Appbar label for editing a group"
-  },
   "@error_creating_group": {
     "description": "Error message when group creation fails"
   },
-  "@error_deleting_group": {
-      "description": "Error message when group deletion fails"
-  },
-  "@error_editing_group": {
-      "description": "Error message when group editing fails"
-  },
   "@error_reading_file": {
     "description": "Error message when file cannot be read"
   },
@@ -309,11 +297,7 @@
   "days_ago": "{count} days ago",
   "delete": "Delete",
   "delete_all_data": "Delete all data",
-  "delete_group": "Delete this group",
-  "edit_group": "Edit Group",
   "error_creating_group": "Error while creating group, please try again",
-  "error_deleting_group": "Error while deleting group, please try again",
-  "error_editing_group": "Error while editing group, please try again",
   "error_reading_file": "Error reading file",
   "export_canceled": "Export canceled",
   "export_data": "Export data",

lib/l10n/generated/app_localizations.dart

@@ -164,13 +164,13 @@ abstract class AppLocalizations {
   /// **'Create match'**
   String get create_match;
 
-  /// Appbar text to create a new group
+  /// Button text to create a new group
   ///
   /// In en, this message translates to:
   /// **'Create new group'**
   String get create_new_group;
 
-  /// Appbar text to create a new match
+  /// Button text to create a new match
   ///
   /// In en, this message translates to:
   /// **'Create new match'**
@@ -218,36 +218,12 @@ abstract class AppLocalizations {
   /// **'Delete all data'**
   String get delete_all_data;
 
-  /// Confirmation dialog for deleting a group
-  ///
-  /// In en, this message translates to:
-  /// **'Delete this group'**
-  String get delete_group;
-
-  /// Button & Appbar label for editing a group
-  ///
-  /// In en, this message translates to:
-  /// **'Edit Group'**
-  String get edit_group;
-
   /// Error message when group creation fails
   ///
   /// In en, this message translates to:
   /// **'Error while creating group, please try again'**
   String get error_creating_group;
 
-  /// Error message when group deletion fails
-  ///
-  /// In en, this message translates to:
-  /// **'Error while deleting group, please try again'**
-  String get error_deleting_group;
-
-  /// Error message when group editing fails
-  ///
-  /// In en, this message translates to:
-  /// **'Error while editing group, please try again'**
-  String get error_editing_group;
-
   /// Error message when file cannot be read
   ///
   /// In en, this message translates to:

lib/l10n/generated/app_localizations_de.dart

@@ -72,24 +72,10 @@ class AppLocalizationsDe extends AppLocalizations {
   @override
   String get delete_all_data => 'Alle Daten löschen';
 
-  @override
-  String get delete_group => 'Diese Gruppe löschen';
-
-  @override
-  String get edit_group => 'Gruppe bearbeiten';
-
   @override
   String get error_creating_group =>
       'Fehler beim Erstellen der Gruppe, bitte erneut versuchen';
 
-  @override
-  String get error_deleting_group =>
-      'Fehler beim Löschen der Gruppe, bitte erneut versuchen';
-
-  @override
-  String get error_editing_group =>
-      'Fehler beim Bearbeiten der Gruppe, bitte erneut versuchen';
-
   @override
   String get error_reading_file => 'Fehler beim Lesen der Datei';
 

lib/l10n/generated/app_localizations_en.dart

@@ -72,24 +72,10 @@ class AppLocalizationsEn extends AppLocalizations {
   @override
   String get delete_all_data => 'Delete all data';
 
-  @override
-  String get delete_group => 'Delete this group';
-
-  @override
-  String get edit_group => 'Edit Group';
-
   @override
   String get error_creating_group =>
       'Error while creating group, please try again';
 
-  @override
-  String get error_deleting_group =>
-      'Error while deleting group, please try again';
-
-  @override
-  String get error_editing_group =>
-      'Error while editing group, please try again';
-
   @override
   String get error_reading_file => 'Error reading file';
 

lib/presentation/views/main_menu/custom_navigation_bar.dart

@@ -12,6 +12,8 @@ import 'package:game_tracker/presentation/views/main_menu/statistics_view.dart';
 import 'package:game_tracker/presentation/widgets/navbar_item.dart';
 
 class CustomNavigationBar extends StatefulWidget {
+  /// A custom navigation bar widget that provides tabbed navigation
+  /// between different views: Home, Matches, Groups, and Statistics.
   const CustomNavigationBar({super.key});
 
   @override

lib/presentation/views/main_menu/group_view/create_group_view.dart

@@ -0,0 +1,114 @@
+import 'package:flutter/material.dart';
+import 'package:game_tracker/core/custom_theme.dart';
+import 'package:game_tracker/core/enums.dart';
+import 'package:game_tracker/data/db/database.dart';
+import 'package:game_tracker/data/dto/group.dart';
+import 'package:game_tracker/data/dto/player.dart';
+import 'package:game_tracker/l10n/generated/app_localizations.dart';
+import 'package:game_tracker/presentation/widgets/buttons/custom_width_button.dart';
+import 'package:game_tracker/presentation/widgets/player_selection.dart';
+import 'package:game_tracker/presentation/widgets/text_input/text_input_field.dart';
+import 'package:provider/provider.dart';
+
+class CreateGroupView extends StatefulWidget {
+  /// A view that allows the user to create a new group
+  const CreateGroupView({super.key});
+
+  @override
+  State<CreateGroupView> createState() => _CreateGroupViewState();
+}
+
+class _CreateGroupViewState extends State<CreateGroupView> {
+  late final AppDatabase db;
+
+  /// Controller for the group name input field
+  final _groupNameController = TextEditingController();
+
+  /// List of currently selected players
+  List<Player> selectedPlayers = [];
+
+  @override
+  void initState() {
+    super.initState();
+    db = Provider.of<AppDatabase>(context, listen: false);
+    _groupNameController.addListener(() {
+      setState(() {});
+    });
+  }
+
+  @override
+  void dispose() {
+    _groupNameController.dispose();
+    super.dispose();
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    final loc = AppLocalizations.of(context);
+    return ScaffoldMessenger(
+      child: Scaffold(
+        backgroundColor: CustomTheme.backgroundColor,
+        appBar: AppBar(title: Text(loc.create_new_group)),
+        body: SafeArea(
+          child: Column(
+            mainAxisAlignment: MainAxisAlignment.start,
+            children: [
+              Container(
+                margin: CustomTheme.standardMargin,
+                child: TextInputField(
+                  controller: _groupNameController,
+                  hintText: loc.group_name,
+                ),
+              ),
+              Expanded(
+                child: PlayerSelection(
+                  onChanged: (value) {
+                    setState(() {
+                      selectedPlayers = [...value];
+                    });
+                  },
+                ),
+              ),
+              CustomWidthButton(
+                text: loc.create_group,
+                sizeRelativeToWidth: 0.95,
+                buttonType: ButtonType.primary,
+                onPressed:
+                    (_groupNameController.text.isEmpty ||
+                        (selectedPlayers.length < 2))
+                    ? null
+                    : () async {
+                        bool success = await db.groupDao.addGroup(
+                          group: Group(
+                            name: _groupNameController.text.trim(),
+                            members: selectedPlayers,
+                          ),
+                        );
+                        if (!context.mounted) return;
+                        if (success) {
+                          Navigator.pop(context);
+                        } else {
+                          ScaffoldMessenger.of(context).showSnackBar(
+                            SnackBar(
+                              backgroundColor: CustomTheme.boxColor,
+                              content: Center(
+                                child: Text(
+                                  AppLocalizations.of(
+                                    context,
+                                  ).error_creating_group,
+                                  style: const TextStyle(color: Colors.white),
+                                ),
+                              ),
+                            ),
+                          );
+                        }
+                      },
+              ),
+              const SizedBox(height: 20),
+            ],
+          ),
+        ),
+      ),
+    );
+  }
+}

lib/presentation/views/main_menu/group_view/group_detail_view.dart

@@ -1,182 +0,0 @@
-import 'package:flutter/material.dart';
-import 'package:game_tracker/core/custom_theme.dart';
-import 'package:game_tracker/core/enums.dart';
-import 'package:game_tracker/data/db/database.dart';
-import 'package:game_tracker/data/dto/group.dart';
-import 'package:game_tracker/data/dto/player.dart';
-import 'package:game_tracker/l10n/generated/app_localizations.dart';
-import 'package:game_tracker/presentation/widgets/buttons/custom_width_button.dart';
-import 'package:game_tracker/presentation/widgets/player_selection.dart';
-import 'package:game_tracker/presentation/widgets/text_input/text_input_field.dart';
-import 'package:provider/provider.dart';
-
-class GroupDetailView extends StatefulWidget {
-  const GroupDetailView({super.key, this.groupToEdit});
-
-  /// The group to edit, if any
-  final Group? groupToEdit;
-
-  @override
-  State<GroupDetailView> createState() => _GroupDetailViewState();
-}
-
-class _GroupDetailViewState extends State<GroupDetailView> {
-  late final AppDatabase db;
-
-  /// GlobalKey for ScaffoldMessenger to show snackbars
-  final _scaffoldMessengerKey = GlobalKey<ScaffoldMessengerState>();
-
-  /// Controller for the group name input field
-  final _groupNameController = TextEditingController();
-
-  /// List of currently selected players
-  List<Player> selectedPlayers = [];
-
-  /// List of initially selected players (when editing a group)
-  List<Player> initialSelectedPlayers = [];
-
-  @override
-  void initState() {
-    super.initState();
-    db = Provider.of<AppDatabase>(context, listen: false);
-    if(widget.groupToEdit != null) {
-      _groupNameController.text = widget.groupToEdit!.name;
-      setState(() {
-        initialSelectedPlayers = widget.groupToEdit!.members;
-        selectedPlayers = widget.groupToEdit!.members;
-      });
-    }
-    _groupNameController.addListener(() {
-      setState(() {});
-    });
-  }
-
-  @override
-  void dispose() {
-    _groupNameController.dispose();
-    super.dispose();
-  }
-
-  @override
-  Widget build(BuildContext context) {
-    final loc = AppLocalizations.of(context);
-    return ScaffoldMessenger(
-      key: _scaffoldMessengerKey,
-      child: Scaffold(
-        backgroundColor: CustomTheme.backgroundColor,
-        appBar: AppBar(title: Text(widget.groupToEdit == null ? loc.create_new_group : loc.edit_group), actions: widget.groupToEdit == null ? [] : [IconButton(icon: const Icon(Icons.delete), onPressed: () async {
-          if(widget.groupToEdit != null) {
-            showDialog<bool>(
-              context: context,
-              builder: (context) => AlertDialog(
-                title: Text(loc.delete_group),
-                content: Text(loc.this_cannot_be_undone),
-                actions: [
-                  TextButton(
-                    onPressed: () => Navigator.of(context).pop(false),
-                    child: Text(loc.cancel),
-                  ),
-                  TextButton(
-                    onPressed: () => Navigator.of(context).pop(true),
-                    child: Text(loc.delete),
-                  ),
-                ],
-              ),
-            ).then((confirmed) async {
-              if (confirmed == true && context.mounted) {
-                bool success = await db.groupDao.deleteGroup(groupId: widget.groupToEdit!.id);
-                if (!context.mounted) return;
-                if (success) {
-                  Navigator.pop(context);
-                } else {
-                  if (!mounted) return;
-                  showSnackbar(message: loc.error_deleting_group);
-                }
-              }
-            });
-          }
-        },)],),
-        body: SafeArea(
-          child: Column(
-            mainAxisAlignment: MainAxisAlignment.start,
-            children: [
-              Container(
-                margin: CustomTheme.standardMargin,
-                child: TextInputField(
-                  controller: _groupNameController,
-                  hintText: loc.group_name,
-                ),
-              ),
-              Expanded(
-                child: PlayerSelection(
-                  initialSelectedPlayers: initialSelectedPlayers,
-                  onChanged: (value) {
-                    setState(() {
-                      selectedPlayers = [...value];
-                    });
-                  },
-                ),
-              ),
-              CustomWidthButton(
-                text: widget.groupToEdit == null ? loc.create_group : loc.edit_group,
-                sizeRelativeToWidth: 0.95,
-                buttonType: ButtonType.primary,
-                onPressed:
-                    (_groupNameController.text.isEmpty ||
-                        (selectedPlayers.length < 2))
-                    ? null
-                    : () async {
-                        late bool success;
-                        if (widget.groupToEdit == null) {
-                          success = await db.groupDao.addGroup(
-                            group: Group(
-                              name: _groupNameController.text.trim(),
-                              members: selectedPlayers,
-                            ),
-                          );
-                        } else {
-                          //TODO: Implement group editing in database
-                          /*
-                          success = await db.groupDao.updateGroup(
-                            group: Group(
-                              id: widget.groupToEdit!.id,
-                              name: _groupNameController.text.trim(),
-                              members: selectedPlayers,
-                            ),
-                          );
-                          */
-                          success = false;
-                        }
-                        if (!context.mounted) return;
-                        if (success) {
-                          Navigator.pop(context);
-                        } else {
-                          showSnackbar(message: widget.groupToEdit == null ? loc.error_creating_group : loc.error_editing_group);
-                        }
-                      },
-              ),
-              const SizedBox(height: 20),
-            ],
-          ),
-        ),
-      ),
-    );
-  }
-  /// Displays a snackbar with the given message and optional action.
-  ///
-  /// [message] The message to display in the snackbar.
-  void showSnackbar({
-    required String message,
-  }) {
-    final messenger = _scaffoldMessengerKey.currentState;
-    if (messenger != null) {
-      messenger.hideCurrentSnackBar();
-      messenger.showSnackBar(
-        SnackBar(
-          content: Text(message, style: const TextStyle(color: Colors.white)),
-          backgroundColor: CustomTheme.boxColor,
-        ),
-      );
-    }
-  }
-}

lib/presentation/views/main_menu/group_view/groups_view.dart

@@ -6,7 +6,7 @@ import 'package:game_tracker/data/db/database.dart';
 import 'package:game_tracker/data/dto/group.dart';
 import 'package:game_tracker/data/dto/player.dart';
 import 'package:game_tracker/l10n/generated/app_localizations.dart';
-import 'package:game_tracker/presentation/views/main_menu/group_view/group_detail_view.dart';
+import 'package:game_tracker/presentation/views/main_menu/group_view/create_group_view.dart';
 import 'package:game_tracker/presentation/widgets/app_skeleton.dart';
 import 'package:game_tracker/presentation/widgets/buttons/main_menu_button.dart';
 import 'package:game_tracker/presentation/widgets/tiles/group_tile.dart';
@@ -14,6 +14,7 @@ import 'package:game_tracker/presentation/widgets/top_centered_message.dart';
 import 'package:provider/provider.dart';
 
 class GroupsView extends StatefulWidget {
+  /// A view that displays a list of groups
   const GroupsView({super.key});
 
   @override
@@ -73,19 +74,7 @@ class _GroupsViewState extends State<GroupsView> {
                       height: MediaQuery.paddingOf(context).bottom - 20,
                     );
                   }
-                  return GroupTile(group: groups[index], onTap: () async {
-                    await Navigator.push(
-                      context,
-                      adaptivePageRoute(
-                        builder: (context) {
-                          return GroupDetailView(groupToEdit: groups[index]);
-                        },
-                      ),
-                    );
-                    setState(() {
-                      loadGroups();
-                    });
-                  });
+                  return GroupTile(group: groups[index]);
                 },
               ),
             ),
@@ -100,7 +89,7 @@ class _GroupsViewState extends State<GroupsView> {
                   context,
                   adaptivePageRoute(
                     builder: (context) {
-                      return const GroupDetailView();
+                      return const CreateGroupView();
                     },
                   ),
                 );

lib/presentation/views/main_menu/home_view.dart

@@ -15,6 +15,8 @@ import 'package:game_tracker/presentation/widgets/tiles/quick_info_tile.dart';
 import 'package:provider/provider.dart';
 
 class HomeView extends StatefulWidget {
+  /// The main home view of the application, displaying quick info,
+  /// recent matches, and quick create options.
   const HomeView({super.key});
 
   @override

lib/presentation/views/main_menu/match_view/create_match/choose_game_view.dart

@@ -6,15 +6,21 @@ import 'package:game_tracker/presentation/widgets/text_input/custom_search_bar.d
 import 'package:game_tracker/presentation/widgets/tiles/title_description_list_tile.dart';
 
 class ChooseGameView extends StatefulWidget {
-  final List<(String, String, Ruleset)> games;
-  final int initialGameIndex;
-
+  /// A view that allows the user to choose a game from a list of available games
+  /// - [games]: A list of tuples containing the game name, description and ruleset
+  /// - [initialGameIndex]: The index of the initially selected game
   const ChooseGameView({
     super.key,
     required this.games,
     required this.initialGameIndex,
   });
 
+  /// A list of tuples containing the game name, description and ruleset
+  final List<(String, String, Ruleset)> games;
+
+  /// The index of the initially selected game
+  final int initialGameIndex;
+
   @override
   State<ChooseGameView> createState() => _ChooseGameViewState();
 }

lib/presentation/views/main_menu/match_view/create_match/choose_group_view.dart

@@ -7,15 +7,21 @@ import 'package:game_tracker/presentation/widgets/tiles/group_tile.dart';
 import 'package:game_tracker/presentation/widgets/top_centered_message.dart';
 
 class ChooseGroupView extends StatefulWidget {
-  final List<Group> groups;
-  final String initialGroupId;
-
+  /// A view that allows the user to choose a group from a list of groups.
+  /// - [groups]: A list of available groups to choose from
+  /// - [initialGroupId]: The ID of the initially selected group
   const ChooseGroupView({
     super.key,
     required this.groups,
     required this.initialGroupId,
   });
 
+  /// A list of available groups to choose from
+  final List<Group> groups;
+
+  /// The ID of the initially selected group
+  final String initialGroupId;
+
   @override
   State<ChooseGroupView> createState() => _ChooseGroupViewState();
 }
@@ -140,10 +146,11 @@ class _ChooseGroupViewState extends State<ChooseGroupView> {
         filteredGroups.clear();
         filteredGroups.addAll(
           widget.groups.where(
-                (group) =>
-            group.name.toLowerCase().contains(query.toLowerCase()) ||
+            (group) =>
+                group.name.toLowerCase().contains(query.toLowerCase()) ||
                 group.members.any(
-                      (player) => player.name.toLowerCase().contains(query.toLowerCase()),
+                  (player) =>
+                      player.name.toLowerCase().contains(query.toLowerCase()),
                 ),
           ),
         );

lib/presentation/views/main_menu/match_view/create_match/choose_ruleset_view.dart

@@ -5,15 +5,21 @@ import 'package:game_tracker/l10n/generated/app_localizations.dart';
 import 'package:game_tracker/presentation/widgets/tiles/title_description_list_tile.dart';
 
 class ChooseRulesetView extends StatefulWidget {
-  final List<(Ruleset, String)> rulesets;
-  final int initialRulesetIndex;
-
+  /// A view that allows the user to choose a ruleset from a list of available rulesets
+  /// - [rulesets]: A list of tuples containing the ruleset and its description
+  /// - [initialRulesetIndex]: The index of the initially selected ruleset
   const ChooseRulesetView({
     super.key,
     required this.rulesets,
     required this.initialRulesetIndex,
   });
 
+  /// A list of tuples containing the ruleset and its description
+  final List<(Ruleset, String)> rulesets;
+
+  /// The index of the initially selected ruleset
+  final int initialRulesetIndex;
+
   @override
   State<ChooseRulesetView> createState() => _ChooseRulesetViewState();
 }

lib/presentation/views/main_menu/match_view/create_match/create_match_view.dart

@@ -18,9 +18,13 @@ import 'package:game_tracker/presentation/widgets/tiles/choose_tile.dart';
 import 'package:provider/provider.dart';
 
 class CreateMatchView extends StatefulWidget {
-  final VoidCallback? onWinnerChanged;
+  /// A view that allows creating a new match
+  /// [onWinnerChanged]: Optional callback invoked when the winner is changed
   const CreateMatchView({super.key, this.onWinnerChanged});
 
+  /// Optional callback invoked when the winner is changed
+  final VoidCallback? onWinnerChanged;
+
   @override
   State<CreateMatchView> createState() => _CreateMatchViewState();
 }
@@ -70,9 +74,6 @@ class _CreateMatchViewState extends State<CreateMatchView> {
   /// List of available rulesets with their localized string representations
   late final List<(Ruleset, String)> _rulesets;
 
-  /// GlobalKey for ScaffoldMessenger to show snackbars
-  final _scaffoldMessengerKey = GlobalKey<ScaffoldMessengerState>();
-
   @override
   void initState() {
     super.initState();
@@ -123,7 +124,6 @@ class _CreateMatchViewState extends State<CreateMatchView> {
   Widget build(BuildContext context) {
     final loc = AppLocalizations.of(context);
     return ScaffoldMessenger(
-      key: _scaffoldMessengerKey,
       child: Scaffold(
         backgroundColor: CustomTheme.backgroundColor,
         appBar: AppBar(title: Text(loc.create_new_match)),
@@ -206,7 +206,8 @@ class _CreateMatchViewState extends State<CreateMatchView> {
                   if (selectedGroup != null) {
                     filteredPlayerList = playerList
                         .where(
-                          (p) => !selectedGroup!.members.any((m) => m.id == p.id),
+                          (p) =>
+                              !selectedGroup!.members.any((m) => m.id == p.id),
                         )
                         .toList();
                   } else {

lib/presentation/views/main_menu/match_view/match_result_view.dart

@@ -8,11 +8,17 @@ import 'package:game_tracker/presentation/widgets/tiles/custom_radio_list_tile.d
 import 'package:provider/provider.dart';
 
 class MatchResultView extends StatefulWidget {
+  /// A view that allows selecting and saving the winner of a match
+  /// [match]: The match for which the winner is to be selected
+  /// [onWinnerChanged]: Optional callback invoked when the winner is changed
+  const MatchResultView({super.key, required this.match, this.onWinnerChanged});
+
+  /// The match for which the winner is to be selected
   final Match match;
 
+  /// Optional callback invoked when the winner is changed
   final VoidCallback? onWinnerChanged;
 
-  const MatchResultView({super.key, required this.match, this.onWinnerChanged});
   @override
   State<MatchResultView> createState() => _MatchResultViewState();
 }

lib/presentation/views/main_menu/match_view/match_view.dart

@@ -19,6 +19,7 @@ import 'package:game_tracker/presentation/widgets/top_centered_message.dart';
 import 'package:provider/provider.dart';
 
 class MatchView extends StatefulWidget {
+  /// A view that displays a list of matches
   const MatchView({super.key});
 
   @override

lib/presentation/views/main_menu/settings_view/licenses/license_detail_view.dart

@@ -5,10 +5,13 @@ import 'package:game_tracker/presentation/views/main_menu/settings_view/licenses
 import 'package:url_launcher/url_launcher.dart';
 
 class LicenseDetailView extends StatelessWidget {
-  final Package package;
-
+  /// A detailed view displaying information about a software package license.
+  /// - [package]: The package data to be displayed.
   const LicenseDetailView({super.key, required this.package});
 
+  /// The package data to be displayed.
+  final Package package;
+
   @override
   Widget build(BuildContext context) {
     final loc = AppLocalizations.of(context);

lib/presentation/views/main_menu/settings_view/licenses_view.dart

@@ -5,6 +5,7 @@ import 'package:game_tracker/presentation/views/main_menu/settings_view/licenses
 import 'package:game_tracker/presentation/widgets/tiles/license_tile.dart';
 
 class LicensesView extends StatelessWidget {
+  /// A view that displays a list of open source licenses used in the app
   const LicensesView({super.key});
 
   @override

lib/presentation/views/main_menu/settings_view/settings_view.dart

@@ -14,6 +14,8 @@ import 'package:package_info_plus/package_info_plus.dart';
 import 'package:url_launcher/url_launcher.dart';
 
 class SettingsView extends StatefulWidget {
+  /// The settings view of the application, allowing users to manage data
+  /// and view legal information.
   const SettingsView({super.key});
 
   @override
@@ -21,17 +23,12 @@ class SettingsView extends StatefulWidget {
 }
 
 class _SettingsViewState extends State<SettingsView> {
-
-  /// GlobalKey for ScaffoldMessenger to show snackbars only on this screen
-  final _scaffoldMessengerKey = GlobalKey<ScaffoldMessengerState>();
-
   PackageInfo _packageInfo = PackageInfo(
     appName: 'n.A.',
     packageName: 'n.A.',
     version: 'n.A.',
     buildNumber: 'n.A.',
   );
-
   @override
   void initState() {
     super.initState();
@@ -42,252 +39,288 @@ class _SettingsViewState extends State<SettingsView> {
   Widget build(BuildContext context) {
     final loc = AppLocalizations.of(context);
     return ScaffoldMessenger(
-      key: _scaffoldMessengerKey,
-      child: Scaffold(
-        appBar: AppBar(backgroundColor: CustomTheme.backgroundColor),
-        backgroundColor: CustomTheme.backgroundColor,
-        body: SingleChildScrollView(
-          child: Column(
-            mainAxisAlignment: MainAxisAlignment.start,
-            crossAxisAlignment: CrossAxisAlignment.start,
-            children: [
-              Padding(
-                padding: const EdgeInsets.only(left: 16, bottom: 10),
-                child: Text(
-                  textAlign: TextAlign.start,
-                  loc.settings,
-                  style: const TextStyle(
-                    fontSize: 28,
-                    fontWeight: FontWeight.bold,
-                  ),
-                ),
-              ),
-              Padding(
-                padding: const EdgeInsets.only(left: 16, top: 10, bottom: 10),
-                child: Text(
-                  textAlign: TextAlign.start,
-                  loc.data,
-                  style: const TextStyle(
-                    fontSize: 22,
-                    fontWeight: FontWeight.bold,
-                  ),
-                ),
-              ),
-              SettingsListTile(
-                title: loc.export_data,
-                icon: Icons.upload,
-                suffixWidget: const Icon(Icons.arrow_forward_ios, size: 16),
-                onPressed: () async {
-                  final String json =
-                      await DataTransferService.getAppDataAsJson(context);
-                  final result = await DataTransferService.exportData(
-                    json,
-                    'game_tracker-data',
-                  );
-                  if (!mounted) return;
-                  showExportSnackBar(result: result);
-                },
-              ),
-              SettingsListTile(
-                title: loc.import_data,
-                icon: Icons.download,
-                suffixWidget: const Icon(Icons.arrow_forward_ios, size: 16),
-                onPressed: () async {
-                  final result = await DataTransferService.importData(context);
-                  if (!mounted) return;
-                  showImportSnackBar(result: result);
-                },
-              ),
-              SettingsListTile(
-                title: loc.delete_all_data,
-                icon: Icons.delete,
-                suffixWidget: const Icon(Icons.arrow_forward_ios, size: 16),
-                onPressed: () {
-                  showDialog<bool>(
-                    context: context,
-                    builder: (context) => AlertDialog(
-                      title: Text('${loc.delete_all_data}?'),
-                      content: Text(loc.this_cannot_be_undone),
-                      actions: [
-                        TextButton(
-                          onPressed: () => Navigator.of(context).pop(false),
-                          child: Text(loc.cancel),
-                        ),
-                        TextButton(
-                          onPressed: () => Navigator.of(context).pop(true),
-                          child: Text(loc.delete),
-                        ),
-                      ],
+      child: Builder(
+        builder: (scaffoldMessengerContext) {
+          return Scaffold(
+            appBar: AppBar(backgroundColor: CustomTheme.backgroundColor),
+            backgroundColor: CustomTheme.backgroundColor,
+            body: SingleChildScrollView(
+              child: Column(
+                mainAxisAlignment: MainAxisAlignment.start,
+                crossAxisAlignment: CrossAxisAlignment.start,
+                children: [
+                  Padding(
+                    padding: const EdgeInsets.only(left: 16, bottom: 10),
+                    child: Text(
+                      textAlign: TextAlign.start,
+                      loc.settings,
+                      style: const TextStyle(
+                        fontSize: 28,
+                        fontWeight: FontWeight.bold,
+                      ),
                     ),
-                  ).then((confirmed) {
-                    if (confirmed == true && context.mounted) {
-                      DataTransferService.deleteAllData(context);
-                      showSnackbar(
-                        message: AppLocalizations.of(
-                          context,
-                        ).data_successfully_deleted,
+                  ),
+                  Padding(
+                    padding: const EdgeInsets.only(
+                      left: 16,
+                      top: 10,
+                      bottom: 10,
+                    ),
+                    child: Text(
+                      textAlign: TextAlign.start,
+                      loc.data,
+                      style: const TextStyle(
+                        fontSize: 22,
+                        fontWeight: FontWeight.bold,
+                      ),
+                    ),
+                  ),
+                  SettingsListTile(
+                    title: loc.export_data,
+                    icon: Icons.upload,
+                    suffixWidget: const Icon(Icons.arrow_forward_ios, size: 16),
+                    onPressed: () async {
+                      final String json =
+                          await DataTransferService.getAppDataAsJson(
+                            scaffoldMessengerContext,
+                          );
+                      final result = await DataTransferService.exportData(
+                        json,
+                        'game_tracker-data',
                       );
-                    }
-                  });
-                },
-              ),
-              Padding(
-                padding: const EdgeInsets.only(left: 16, top: 10, bottom: 10),
-                child: Text(
-                  textAlign: TextAlign.start,
-                  loc.legal,
-                  style: const TextStyle(
-                    fontSize: 22,
-                    fontWeight: FontWeight.bold,
+                      if (!scaffoldMessengerContext.mounted) return;
+                      showExportSnackBar(
+                        context: scaffoldMessengerContext,
+                        result: result,
+                      );
+                    },
                   ),
-                ),
-              ),
-              SettingsListTile(
-                title: loc.licenses,
-                icon: Icons.insert_drive_file,
-                suffixWidget: const Icon(Icons.arrow_forward_ios, size: 16),
-                onPressed: () {
-                  Navigator.of(context).push(
-                    MaterialPageRoute(
-                      builder: (context) => const LicensesView(),
-                    ),
-                  );
-                },
-              ),
-              SettingsListTile(
-                title: loc.legal_notice,
-                icon: Icons.account_balance_sharp,
-                suffixWidget: const Icon(Icons.arrow_forward_ios, size: 16),
-                onPressed: null,
-              ),
-              SettingsListTile(
-                title: loc.privacy_policy,
-                icon: Icons.gpp_good_rounded,
-                suffixWidget: const Icon(Icons.arrow_forward_ios, size: 16),
-                onPressed: null,
-              ),
-              Padding(
-                padding: const EdgeInsets.only(top: 30, bottom: 20),
-                child: Center(
-                  child: Column(
-                    spacing: 4,
-                    children: [
-                      Padding(
-                        padding: const EdgeInsets.only(bottom: 12),
-                        child: Row(
-                          mainAxisAlignment: MainAxisAlignment.center,
-                          spacing: 40,
-                          children: [
-                            GestureDetector(
-                              child: const Icon(Icons.language),
-                              onTap: () => {
-                                launchUrl(Uri.parse('https://liquid-dev.de')),
-                              },
+                  SettingsListTile(
+                    title: loc.import_data,
+                    icon: Icons.download,
+                    suffixWidget: const Icon(Icons.arrow_forward_ios, size: 16),
+                    onPressed: () async {
+                      final result = await DataTransferService.importData(
+                        scaffoldMessengerContext,
+                      );
+                      if (!scaffoldMessengerContext.mounted) return;
+                      showImportSnackBar(
+                        context: scaffoldMessengerContext,
+                        result: result,
+                      );
+                    },
+                  ),
+                  SettingsListTile(
+                    title: loc.delete_all_data,
+                    icon: Icons.delete,
+                    suffixWidget: const Icon(Icons.arrow_forward_ios, size: 16),
+                    onPressed: () {
+                      showDialog<bool>(
+                        context: scaffoldMessengerContext,
+                        builder: (dialogContext) => AlertDialog(
+                          title: Text('${loc.delete_all_data}?'),
+                          content: Text(loc.this_cannot_be_undone),
+                          actions: [
+                            TextButton(
+                              onPressed: () =>
+                                  Navigator.of(dialogContext).pop(false),
+                              child: Text(loc.cancel),
                             ),
-                            GestureDetector(
-                              child: const FaIcon(FontAwesomeIcons.github),
-                              onTap: () => {
-                                launchUrl(
-                                  Uri.parse(
-                                    'https://github.com/liquiddevelopmentde',
-                                  ),
-                                ),
-                              },
-                            ),
-                            GestureDetector(
-                              child: Icon(
-                                Platform.isIOS
-                                    ? CupertinoIcons.mail_solid
-                                    : Icons.email,
-                              ),
-                              onTap: () => launchUrl(
-                                Uri.parse('mailto:hi@liquid-dev.de'),
-                              ),
+                            TextButton(
+                              onPressed: () =>
+                                  Navigator.of(dialogContext).pop(true),
+                              child: Text(loc.delete),
                             ),
                           ],
                         ),
-                      ),
-                      Text(
-                        '© ${DateFormat('yyyy').format(DateTime.now())} Liquid Development',
-                        style: TextStyle(
-                          color: Colors.grey.shade600,
-                          fontSize: 14,
-                          fontWeight: FontWeight.w600,
-                        ),
-                      ),
-                      Text(
-                        'Version ${_packageInfo.version} (${_packageInfo.buildNumber})',
-                        style: TextStyle(
-                          color: Colors.grey.shade600,
-                          fontSize: 14,
-                          fontWeight: FontWeight.w600,
-                        ),
-                      ),
-                    ],
+                      ).then((confirmed) {
+                        if (confirmed == true &&
+                            scaffoldMessengerContext.mounted) {
+                          DataTransferService.deleteAllData(
+                            scaffoldMessengerContext,
+                          );
+                          showSnackbar(
+                            context: scaffoldMessengerContext,
+                            message: AppLocalizations.of(
+                              scaffoldMessengerContext,
+                            ).data_successfully_deleted,
+                          );
+                        }
+                      });
+                    },
                   ),
-                ),
+                  Padding(
+                    padding: const EdgeInsets.only(
+                      left: 16,
+                      top: 10,
+                      bottom: 10,
+                    ),
+                    child: Text(
+                      textAlign: TextAlign.start,
+                      loc.legal,
+                      style: const TextStyle(
+                        fontSize: 22,
+                        fontWeight: FontWeight.bold,
+                      ),
+                    ),
+                  ),
+                  SettingsListTile(
+                    title: loc.licenses,
+                    icon: Icons.insert_drive_file,
+                    suffixWidget: const Icon(Icons.arrow_forward_ios, size: 16),
+                    onPressed: () {
+                      Navigator.of(context).push(
+                        MaterialPageRoute(
+                          builder: (context) => const LicensesView(),
+                        ),
+                      );
+                    },
+                  ),
+                  SettingsListTile(
+                    title: loc.legal_notice,
+                    icon: Icons.account_balance_sharp,
+                    suffixWidget: const Icon(Icons.arrow_forward_ios, size: 16),
+                    onPressed: null,
+                  ),
+                  SettingsListTile(
+                    title: loc.privacy_policy,
+                    icon: Icons.gpp_good_rounded,
+                    suffixWidget: const Icon(Icons.arrow_forward_ios, size: 16),
+                    onPressed: null,
+                  ),
+                  Padding(
+                    padding: const EdgeInsets.only(top: 30, bottom: 20),
+                    child: Center(
+                      child: Column(
+                        spacing: 4,
+                        children: [
+                          Padding(
+                            padding: const EdgeInsets.only(bottom: 12),
+                            child: Row(
+                              mainAxisAlignment: MainAxisAlignment.center,
+                              spacing: 40,
+                              children: [
+                                GestureDetector(
+                                  child: const Icon(Icons.language),
+                                  onTap: () => {
+                                    launchUrl(
+                                      Uri.parse('https://liquid-dev.de'),
+                                    ),
+                                  },
+                                ),
+                                GestureDetector(
+                                  child: const FaIcon(FontAwesomeIcons.github),
+                                  onTap: () => {
+                                    launchUrl(
+                                      Uri.parse(
+                                        'https://github.com/liquiddevelopmentde',
+                                      ),
+                                    ),
+                                  },
+                                ),
+                                GestureDetector(
+                                  child: Icon(
+                                    Platform.isIOS
+                                        ? CupertinoIcons.mail_solid
+                                        : Icons.email,
+                                  ),
+                                  onTap: () => launchUrl(
+                                    Uri.parse('mailto:hi@liquid-dev.de'),
+                                  ),
+                                ),
+                              ],
+                            ),
+                          ),
+                          Text(
+                            '© ${DateFormat('yyyy').format(DateTime.now())} Liquid Development',
+                            style: TextStyle(
+                              color: Colors.grey.shade600,
+                              fontSize: 14,
+                              fontWeight: FontWeight.w600,
+                            ),
+                          ),
+                          Text(
+                            'Version ${_packageInfo.version} (${_packageInfo.buildNumber})',
+                            style: TextStyle(
+                              color: Colors.grey.shade600,
+                              fontSize: 14,
+                              fontWeight: FontWeight.w600,
+                            ),
+                          ),
+                        ],
+                      ),
+                    ),
+                  ),
+                ],
               ),
-            ],
-          ),
-        ),
+            ),
+          );
+        },
       ),
     );
   }
 
   /// Displays a snackbar based on the import result.
   ///
+  /// [context] The BuildContext to show the snackbar in.
   /// [result] The result of the import operation.
   void showImportSnackBar({
+    required BuildContext context,
     required ImportResult result,
   }) {
     final loc = AppLocalizations.of(context);
     switch (result) {
       case ImportResult.success:
-        showSnackbar(message: loc.data_successfully_imported);
+        showSnackbar(context: context, message: loc.data_successfully_imported);
       case ImportResult.invalidSchema:
-        showSnackbar(message: loc.invalid_schema);
+        showSnackbar(context: context, message: loc.invalid_schema);
       case ImportResult.fileReadError:
-        showSnackbar(message: loc.error_reading_file);
+        showSnackbar(context: context, message: loc.error_reading_file);
       case ImportResult.canceled:
-        showSnackbar(message: loc.import_canceled);
+        showSnackbar(context: context, message: loc.import_canceled);
       case ImportResult.formatException:
-        showSnackbar(message: loc.format_exception);
+        showSnackbar(context: context, message: loc.format_exception);
       case ImportResult.unknownException:
-        showSnackbar(message: loc.unknown_exception);
+        showSnackbar(context: context, message: loc.unknown_exception);
     }
   }
 
   /// Displays a snackbar based on the export result.
   ///
+  /// [context] The BuildContext to show the snackbar in.
   /// [result] The result of the export operation.
   void showExportSnackBar({
+    required BuildContext context,
     required ExportResult result,
   }) {
     final loc = AppLocalizations.of(context);
     switch (result) {
       case ExportResult.success:
-        showSnackbar(message: loc.data_successfully_exported);
+        showSnackbar(context: context, message: loc.data_successfully_exported);
       case ExportResult.canceled:
-        showSnackbar(message: loc.export_canceled);
+        showSnackbar(context: context, message: loc.export_canceled);
       case ExportResult.unknownException:
-        showSnackbar(message: loc.unknown_exception);
+        showSnackbar(context: context, message: loc.unknown_exception);
     }
   }
 
   /// Displays a snackbar with the given message and optional action.
   ///
+  /// [context] The BuildContext to show the snackbar in.
   /// [message] The message to display in the snackbar.
   /// [duration] The duration for which the snackbar is displayed.
   /// [action] An optional callback function to execute when the action button is pressed.
   void showSnackbar({
+    required BuildContext context,
     required String message,
     Duration duration = const Duration(seconds: 3),
     VoidCallback? action,
   }) {
+    if (!context.mounted) return;
+
     final loc = AppLocalizations.of(context);
-    final messenger = _scaffoldMessengerKey.currentState!;
-    messenger.hideCurrentSnackBar();
-    messenger.showSnackBar(
+    ScaffoldMessenger.of(context).hideCurrentSnackBar();
+    ScaffoldMessenger.of(context).showSnackBar(
       SnackBar(
         content: Text(message, style: const TextStyle(color: Colors.white)),
         backgroundColor: CustomTheme.onBoxColor,

lib/presentation/views/main_menu/statistics_view.dart

@@ -10,6 +10,7 @@ import 'package:game_tracker/presentation/widgets/top_centered_message.dart';
 import 'package:provider/provider.dart';
 
 class StatisticsView extends StatefulWidget {
+  /// A view that displays player statistics
   const StatisticsView({super.key});
 
   @override

lib/presentation/widgets/app_skeleton.dart

@@ -1,11 +1,11 @@
 import 'package:flutter/material.dart';
 import 'package:skeletonizer/skeletonizer.dart';
 
-/// A widget that provides a skeleton loading effect to its child widget tree.
-/// - [child]: The widget tree to apply the skeleton effect to.
-/// - [enabled]: A boolean to enable or disable the skeleton effect.
-/// - [fixLayoutBuilder]: A boolean to fix the layout builder for AnimatedSwitcher.
 class AppSkeleton extends StatefulWidget {
+  /// A widget that provides a skeleton loading effect to its child widget tree.
+  /// - [child]: The widget tree to apply the skeleton effect to.
+  /// - [enabled]: A boolean to enable or disable the skeleton effect.
+  /// - [fixLayoutBuilder]: A boolean to fix the layout builder for AnimatedSwitcher.
   const AppSkeleton({
     super.key,
     required this.child,

lib/presentation/widgets/buttons/custom_width_button.dart

@@ -2,13 +2,13 @@ import 'package:flutter/material.dart';
 import 'package:game_tracker/core/custom_theme.dart';
 import 'package:game_tracker/core/enums.dart';
 
-/// A custom button widget that is designed to have a width relative to the screen size.
-/// It supports three types of buttons: primary, secondary, and text buttons.
-/// - [text]: The text to display on the button.
-/// - [buttonType]: The type of button to display. Defaults to [ButtonType.primary].
-/// - [sizeRelativeToWidth]: The size of the button relative to the width of the screen.
-/// - [onPressed]: The callback to be invoked when the button is pressed.
 class CustomWidthButton extends StatelessWidget {
+  /// A custom button widget that is designed to have a width relative to the screen size.
+  /// It supports three types of buttons: primary, secondary, and text buttons.
+  /// - [text]: The text to display on the button.
+  /// - [buttonType]: The type of button to display. Defaults to [ButtonType.primary].
+  /// - [sizeRelativeToWidth]: The size of the button relative to the width of the screen.
+  /// - [onPressed]: The callback to be invoked when the button is pressed.
   const CustomWidthButton({
     super.key,
     required this.text,

lib/presentation/widgets/buttons/main_menu_button.dart

@@ -1,10 +1,10 @@
 import 'package:flutter/material.dart';
 
-/// A button for the main menu with an optional icon and a press animation.
-/// - [text]: The text of the button.
-/// - [icon]: The icon of the button.
-/// - [onPressed]: The callback to be invoked when the button is pressed.
 class MainMenuButton extends StatefulWidget {
+  /// A button for the main menu with an optional icon and a press animation.
+  /// - [text]: The text of the button.
+  /// - [icon]: The icon of the button.
+  /// - [onPressed]: The callback to be invoked when the button is pressed.
   const MainMenuButton({
     super.key,
     required this.text,

lib/presentation/widgets/buttons/quick_create_button.dart

@@ -1,10 +1,10 @@
 import 'package:flutter/material.dart';
 import 'package:game_tracker/core/custom_theme.dart';
 
-/// A button widget designed for quick creating matches in the [HomeView]
-/// - [text]: The text to display on the button.
-/// - [onPressed]: The callback to be invoked when the button is pressed.
 class QuickCreateButton extends StatefulWidget {
+  /// A button widget designed for quick creating matches in the [HomeView]
+  /// - [text]: The text to display on the button.
+  /// - [onPressed]: The callback to be invoked when the button is pressed.
   const QuickCreateButton({
     super.key,
     required this.text,

lib/presentation/widgets/navbar_item.dart

@@ -1,13 +1,13 @@
 import 'package:flutter/material.dart';
 import 'package:game_tracker/core/custom_theme.dart';
 
-/// A navigation bar item widget that represents a single tab in a navigation bar.
-/// - [index]: The index of the tab.
-/// - [isSelected]: A boolean indicating whether the tab is currently selected.
-/// - [icon]: The icon to display for the tab.
-/// - [label]: The label to display for the tab.
-/// - [onTabTapped]: The callback to be invoked when the tab is tapped.
 class NavbarItem extends StatefulWidget {
+  /// A navigation bar item widget that represents a single tab in a navigation bar.
+  /// - [index]: The index of the tab.
+  /// - [isSelected]: A boolean indicating whether the tab is currently selected.
+  /// - [icon]: The icon to display for the tab.
+  /// - [label]: The label to display for the tab.
+  /// - [onTabTapped]: The callback to be invoked when the tab is tapped.
   const NavbarItem({
     super.key,
     required this.index,

lib/presentation/widgets/player_selection.dart

@@ -11,14 +11,14 @@ import 'package:game_tracker/presentation/widgets/tiles/text_icon_tile.dart';
 import 'package:game_tracker/presentation/widgets/top_centered_message.dart';
 import 'package:provider/provider.dart';
 
-/// A widget that allows users to select players from a list,
-/// with search functionality and the ability to add new players.
-/// - [availablePlayers]: An optional list of players to choose from. If null, all
-///   players from the database are used.
-/// - [initialSelectedPlayers]: An optional list of players that should be pre-selected.
-/// - [onChanged]: A callback function that is invoked whenever the selection changes,
-///   providing the updated list of selected players.
 class PlayerSelection extends StatefulWidget {
+  /// A widget that allows users to select players from a list,
+  /// with search functionality and the ability to add new players.
+  /// - [availablePlayers]: An optional list of players to choose from. If null,
+  ///   all players from the database are used.
+  /// - [initialSelectedPlayers]: An optional list of players that should be pre-selected.
+  /// - [onChanged]: A callback function that is invoked whenever the selection
+  ///   changes, providing the updated list of selected players.
   const PlayerSelection({
     super.key,
     this.availablePlayers,
@@ -70,7 +70,6 @@ class _PlayerSelectionState extends State<PlayerSelection> {
     super.initState();
     db = Provider.of<AppDatabase>(context, listen: false);
     suggestedPlayers = skeletonData;
-    selectedPlayers = widget.initialSelectedPlayers ?? [];
     loadPlayerList();
   }
 
@@ -100,7 +99,7 @@ class _PlayerSelectionState extends State<PlayerSelection> {
                 if (value.isEmpty) {
                   // If the search is empty, it shows all unselected players.
                   suggestedPlayers = allPlayers.where((player) {
-                    return !selectedPlayers.any((p) => p.id == player.id);
+                    return !selectedPlayers.contains(player);
                   }).toList();
                 } else {
                   // If there is input, it filters by name match (case-insensitive) and ensures
@@ -109,7 +108,9 @@ class _PlayerSelectionState extends State<PlayerSelection> {
                     final bool nameMatches = player.name.toLowerCase().contains(
                       value.toLowerCase(),
                     );
-                    final bool isNotSelected = !selectedPlayers.any((p) => p.id == player.id);
+                    final bool isNotSelected = !selectedPlayers.contains(
+                      player,
+                    );
                     return nameMatches && isNotSelected;
                   }).toList();
                 }
@@ -124,49 +125,46 @@ class _PlayerSelectionState extends State<PlayerSelection> {
           const SizedBox(height: 10),
           SizedBox(
             height: 50,
-            child: AppSkeleton(
-              enabled: isLoading,
-              child: selectedPlayers.isEmpty
-                  ? Center(child: Text(loc.no_players_selected))
-                  : SingleChildScrollView(
-                      scrollDirection: Axis.horizontal,
-                      child: Row(
-                        children: [
-                          for (var player in selectedPlayers)
-                            Padding(
-                              padding: const EdgeInsets.only(right: 8.0),
-                              child: TextIconTile(
-                                text: player.name,
-                                onIconTap: () {
-                                  setState(() {
-                                    // Removes the player from the selection and notifies the parent.
-                                    selectedPlayers.remove(player);
-                                    widget.onChanged([...selectedPlayers]);
+            child: selectedPlayers.isEmpty
+                ? Center(child: Text(loc.no_players_selected))
+                : SingleChildScrollView(
+                    scrollDirection: Axis.horizontal,
+                    child: Row(
+                      children: [
+                        for (var player in selectedPlayers)
+                          Padding(
+                            padding: const EdgeInsets.only(right: 8.0),
+                            child: TextIconTile(
+                              text: player.name,
+                              onIconTap: () {
+                                setState(() {
+                                  // Removes the player from the selection and notifies the parent.
+                                  selectedPlayers.remove(player);
+                                  widget.onChanged([...selectedPlayers]);
 
-                                    // Get the current search query
-                                    final currentSearch = _searchBarController
-                                        .text
-                                        .toLowerCase();
+                                  // Get the current search query
+                                  final currentSearch = _searchBarController
+                                      .text
+                                      .toLowerCase();
 
-                                    // If the player matches the current search query (or search is empty),
-                                    // they are added back to the `suggestedPlayers` and the list is re-sorted.
-                                    if (currentSearch.isEmpty ||
-                                        player.name.toLowerCase().contains(
-                                          currentSearch,
-                                        )) {
-                                      suggestedPlayers.add(player);
-                                      suggestedPlayers.sort(
-                                        (a, b) => a.name.compareTo(b.name),
-                                      );
-                                    }
-                                  });
-                                },
-                              ),
+                                  // If the player matches the current search query (or search is empty),
+                                  // they are added back to the `suggestedPlayers` and the list is re-sorted.
+                                  if (currentSearch.isEmpty ||
+                                      player.name.toLowerCase().contains(
+                                        currentSearch,
+                                      )) {
+                                    suggestedPlayers.add(player);
+                                    suggestedPlayers.sort(
+                                      (a, b) => a.name.compareTo(b.name),
+                                    );
+                                  }
+                                });
+                              },
                             ),
-                        ],
-                      ),
+                          ),
+                      ],
                     ),
-            ),
+                  ),
           ),
           const SizedBox(height: 10),
           Text(
@@ -246,21 +244,7 @@ class _PlayerSelectionState extends State<PlayerSelection> {
             // Otherwise, use the loaded players from the database.
             loadedPlayers.sort((a, b) => a.name.compareTo(b.name));
             allPlayers = [...loadedPlayers];
-            if (widget.initialSelectedPlayers != null) {
-              // Excludes already selected players from the suggested players list.
-              suggestedPlayers = loadedPlayers.where((p) => !widget.initialSelectedPlayers!.any((ip) => ip.id == p.id)).toList();
-              // Ensures that only players available for selection are pre-selected.
-              selectedPlayers = widget.initialSelectedPlayers!
-                  .where(
-                    (p) => allPlayers.any(
-                      (available) => available.id == p.id,
-                ),
-              )
-                  .toList();
-            } else {
-              // If no initial selection, all loaded players are suggested.
-              suggestedPlayers = [...loadedPlayers];
-            }
+            suggestedPlayers = [...loadedPlayers];
           }
           isLoading = false;
         });
@@ -311,6 +295,7 @@ class _PlayerSelectionState extends State<PlayerSelection> {
   /// [message] - The message to display in the snackbar.
   void showSnackBarMessage(String message) {
     if (!context.mounted) return;
+    ScaffoldMessenger.of(context).hideCurrentSnackBar();
     ScaffoldMessenger.of(context).showSnackBar(
       SnackBar(
         backgroundColor: CustomTheme.boxColor,

lib/presentation/widgets/text_input/custom_search_bar.dart

@@ -1,16 +1,16 @@
 import 'package:flutter/material.dart';
 import 'package:game_tracker/core/custom_theme.dart';
 
-/// A custom search bar widget that encapsulates a [SearchBar] with additional customization options.
-/// - [controller]: The controller for the search bar's text input.
-/// - [hintText]: The hint text displayed in the search bar when it is empty.
-/// - [trailingButtonShown]: Whether to show the trailing button.
-/// - [trailingButtonicon]: The icon for the trailing button.
-/// - [trailingButtonEnabled]: Whether the trailing button is in enabled state.
-/// - [onTrailingButtonPressed]: The callback invoked when the trailing button is pressed.
-/// - [onChanged]: The callback invoked when the text in the search bar changes.
-/// - [constraints]: The constraints for the search bar.
 class CustomSearchBar extends StatelessWidget {
+  /// A custom search bar widget that encapsulates a [SearchBar] with additional customization options.
+  /// - [controller]: The controller for the search bar's text input.
+  /// - [hintText]: The hint text displayed in the search bar when it is empty.
+  /// - [trailingButtonShown]: Whether to show the trailing button.
+  /// - [trailingButtonicon]: The icon for the trailing button.
+  /// - [trailingButtonEnabled]: Whether the trailing button is in enabled state.
+  /// - [onTrailingButtonPressed]: The callback invoked when the trailing button is pressed.
+  /// - [onChanged]: The callback invoked when the text in the search bar changes.
+  /// - [constraints]: The constraints for the search bar.
   const CustomSearchBar({
     super.key,
     required this.controller,

lib/presentation/widgets/text_input/text_input_field.dart

@@ -1,11 +1,11 @@
 import 'package:flutter/material.dart';
 import 'package:game_tracker/core/custom_theme.dart';
 
-/// A custom text input field widget that encapsulates a [TextField] with specific styling.
-/// - [controller]: The controller for the text input field.
-/// - [onChanged]: The callback invoked when the text in the field changes.
-/// - [hintText]: The hint text displayed in the text input field when it is empty
 class TextInputField extends StatelessWidget {
+  /// A custom text input field widget that encapsulates a [TextField] with specific styling.
+  /// - [controller]: The controller for the text input field.
+  /// - [onChanged]: The callback invoked when the text in the field changes.
+  /// - [hintText]: The hint text displayed in the text input field when it is empty
   const TextInputField({
     super.key,
     required this.controller,

lib/presentation/widgets/tiles/choose_tile.dart

@@ -1,11 +1,11 @@
 import 'package:flutter/material.dart';
 import 'package:game_tracker/core/custom_theme.dart';
 
-/// A tile widget that allows users to choose an option by tapping on it.
-/// - [title]: The title text displayed on the tile.
-/// - [trailingText]: Optional trailing text displayed on the tile.
-/// - [onPressed]: The callback invoked when the tile is tapped.
 class ChooseTile extends StatefulWidget {
+  /// A tile widget that allows users to choose an option by tapping on it.
+  /// - [title]: The title text displayed on the tile.
+  /// - [trailingText]: Optional trailing text displayed on the tile.
+  /// - [onPressed]: The callback invoked when the tile is tapped.
   const ChooseTile({
     super.key,
     required this.title,

lib/presentation/widgets/tiles/custom_radio_list_tile.dart

@@ -1,11 +1,11 @@
 import 'package:flutter/material.dart';
 import 'package:game_tracker/core/custom_theme.dart';
 
-/// A custom radio list tile widget that encapsulates a [Radio] button with additional styling and functionality.
-/// - [text]: The text to display next to the radio button.
-/// - [value]: The value associated with the radio button.
-/// - [onContainerTap]: The callback invoked when the container is tapped.
 class CustomRadioListTile<T> extends StatelessWidget {
+  /// A custom radio list tile widget that encapsulates a [Radio] button with additional styling and functionality.
+  /// - [text]: The text to display next to the radio button.
+  /// - [value]: The value associated with the radio button.
+  /// - [onContainerTap]: The callback invoked when the container is tapped.
   const CustomRadioListTile({
     super.key,
     required this.text,

lib/presentation/widgets/tiles/group_tile.dart

@@ -3,12 +3,11 @@ import 'package:game_tracker/core/custom_theme.dart';
 import 'package:game_tracker/data/dto/group.dart';
 import 'package:game_tracker/presentation/widgets/tiles/text_icon_tile.dart';
 
-/// A tile widget that displays information about a group, including its name and members.
-/// - [group]: The group data to be displayed.
-/// - [isHighlighted]: Whether the tile should be highlighted.
-/// - [onTap]: An optional callback function to handle tap events.
 class GroupTile extends StatelessWidget {
-  const GroupTile({super.key, required this.group, this.isHighlighted = false, this.onTap});
+  /// A tile widget that displays information about a group, including its name and members.
+  /// - [group]: The group data to be displayed.
+  /// - [isHighlighted]: Whether the tile should be highlighted.
+  const GroupTile({super.key, required this.group, this.isHighlighted = false});
 
   /// The group data to be displayed.
   final Group group;
@@ -16,67 +15,61 @@ class GroupTile extends StatelessWidget {
   /// Whether the tile should be highlighted.
   final bool isHighlighted;
 
-  /// Callback function to handle tap events.
-  final VoidCallback? onTap;
-
   @override
   Widget build(BuildContext context) {
-    return GestureDetector(
-      onTap: onTap,
-      child: AnimatedContainer(
-        margin: CustomTheme.standardMargin,
-        padding: const EdgeInsets.symmetric(vertical: 5, horizontal: 10),
-        decoration: isHighlighted
-            ? CustomTheme.highlightedBoxDecoration
-            : CustomTheme.standardBoxDecoration,
-        duration: const Duration(milliseconds: 150),
-        child: Column(
-          crossAxisAlignment: CrossAxisAlignment.start,
-          children: [
-            Row(
-              mainAxisAlignment: MainAxisAlignment.spaceBetween,
-              children: [
-                Flexible(
-                  child: Text(
-                    group.name,
-                    overflow: TextOverflow.ellipsis,
+    return AnimatedContainer(
+      margin: CustomTheme.standardMargin,
+      padding: const EdgeInsets.symmetric(vertical: 5, horizontal: 10),
+      decoration: isHighlighted
+          ? CustomTheme.highlightedBoxDecoration
+          : CustomTheme.standardBoxDecoration,
+      duration: const Duration(milliseconds: 150),
+      child: Column(
+        crossAxisAlignment: CrossAxisAlignment.start,
+        children: [
+          Row(
+            mainAxisAlignment: MainAxisAlignment.spaceBetween,
+            children: [
+              Flexible(
+                child: Text(
+                  group.name,
+                  overflow: TextOverflow.ellipsis,
+                  style: const TextStyle(
+                    fontWeight: FontWeight.bold,
+                    fontSize: 18,
+                  ),
+                ),
+              ),
+              Row(
+                children: [
+                  Text(
+                    '${group.members.length}',
                     style: const TextStyle(
-                      fontWeight: FontWeight.bold,
+                      fontWeight: FontWeight.w900,
                       fontSize: 18,
                     ),
                   ),
-                ),
-                Row(
-                  children: [
-                    Text(
-                      '${group.members.length}',
-                      style: const TextStyle(
-                        fontWeight: FontWeight.w900,
-                        fontSize: 18,
-                      ),
-                    ),
-                    const SizedBox(width: 3),
-                    const Icon(Icons.group, size: 22),
-                  ],
-                ),
-              ],
-            ),
-            const SizedBox(height: 5),
-            Wrap(
-              alignment: WrapAlignment.start,
-              crossAxisAlignment: WrapCrossAlignment.start,
-              spacing: 12.0,
-              runSpacing: 8.0,
-              children: <Widget>[
-                for (var member in [
-                  ...group.members,
-                ]..sort((a, b) => a.name.compareTo(b.name)))
-                  TextIconTile(text: member.name, iconEnabled: false),
-              ],
-            ),
-            const SizedBox(height: 2.5),
-          ],
-        ),
+                  const SizedBox(width: 3),
+                  const Icon(Icons.group, size: 22),
+                ],
+              ),
+            ],
+          ),
+          const SizedBox(height: 5),
+          Wrap(
+            alignment: WrapAlignment.start,
+            crossAxisAlignment: WrapCrossAlignment.start,
+            spacing: 12.0,
+            runSpacing: 8.0,
+            children: <Widget>[
+              for (var member in [
+                ...group.members,
+              ]..sort((a, b) => a.name.compareTo(b.name)))
+                TextIconTile(text: member.name, iconEnabled: false),
+            ],
+          ),
+          const SizedBox(height: 2.5),
+        ],
       ),
     );
   }

lib/presentation/widgets/tiles/info_tile.dart

@@ -1,14 +1,14 @@
 import 'package:flutter/material.dart';
 import 'package:game_tracker/core/custom_theme.dart';
 
-/// A tile widget that displays a title with an icon and some content below it.
-/// - [title]: The title text displayed on the tile.
-/// - [icon]: The icon displayed next to the title.
-/// - [content]: The content widget displayed below the title.
-/// - [padding]: Optional padding for the tile content.
-/// - [height]: Optional height for the tile.
-/// - [width]: Optional width for the tile.
 class InfoTile extends StatefulWidget {
+  /// A tile widget that displays a title with an icon and some content below it.
+  /// - [title]: The title text displayed on the tile.
+  /// - [icon]: The icon displayed next to the title.
+  /// - [content]: The content widget displayed below the title.
+  /// - [padding]: Optional padding for the tile content.
+  /// - [height]: Optional height for the tile.
+  /// - [width]: Optional width for the tile.
   const InfoTile({
     super.key,
     required this.title,

lib/presentation/widgets/tiles/license_tile.dart

@@ -4,10 +4,13 @@ import 'package:game_tracker/presentation/views/main_menu/settings_view/licenses
 import 'package:game_tracker/presentation/views/main_menu/settings_view/licenses/oss_licenses.dart';
 
 class LicenseTile extends StatelessWidget {
-  final Package package;
-
+  /// A tile widget that displays information about a software package license.
+  /// - [package]: The package data to be displayed.
   const LicenseTile({super.key, required this.package});
 
+  /// The package data to be displayed.
+  final Package package;
+
   @override
   Widget build(BuildContext context) {
     return GestureDetector(

lib/presentation/widgets/tiles/match_summary_tile.dart

@@ -1,95 +0,0 @@
-import 'package:flutter/material.dart';
-import 'package:game_tracker/core/custom_theme.dart';
-import 'package:skeletonizer/skeletonizer.dart';
-
-class MatchSummaryTile extends StatefulWidget {
-  final String matchTitle;
-  final String game;
-  final String ruleset;
-  final String players;
-  final String winner;
-
-  const MatchSummaryTile({
-    super.key,
-    required this.matchTitle,
-    required this.game,
-    required this.ruleset,
-    required this.players,
-    required this.winner,
-  });
-
-  @override
-  State<MatchSummaryTile> createState() => _MatchSummaryTileState();
-}
-
-class _MatchSummaryTileState extends State<MatchSummaryTile> {
-  @override
-  Widget build(BuildContext context) {
-    return Column(
-      crossAxisAlignment: CrossAxisAlignment.start,
-      children: [
-        Row(
-          children: [
-            Text(
-              widget.matchTitle,
-              style: const TextStyle(fontSize: 18, fontWeight: FontWeight.bold),
-            ),
-            const SizedBox(width: 5),
-            Text(
-              widget.game,
-              style: const TextStyle(fontSize: 14, color: Colors.grey),
-            ),
-          ],
-        ),
-        const SizedBox(height: 5),
-        Container(
-          padding: const EdgeInsets.symmetric(horizontal: 4),
-          height: 20,
-          decoration: BoxDecoration(
-            borderRadius: BorderRadius.circular(4),
-            color: CustomTheme.primaryColor,
-          ),
-          child: Skeleton.ignore(
-            child: Text(
-              widget.ruleset,
-              style: const TextStyle(fontWeight: FontWeight.bold),
-            ),
-          ),
-        ),
-        Center(
-          heightFactor: 1.5,
-          child: Text(
-            widget.players,
-            style: const TextStyle(fontWeight: FontWeight.bold),
-          ),
-        ),
-        Center(
-          child: Container(
-            padding: const EdgeInsets.symmetric(horizontal: 4),
-            width: 220,
-            decoration: BoxDecoration(
-              borderRadius: BorderRadius.circular(4),
-              color: Colors.yellow.shade300,
-            ),
-            child: Skeleton.ignore(
-              child: Row(
-                mainAxisAlignment: MainAxisAlignment.center,
-                children: [
-                  const Icon(Icons.emoji_events, color: Colors.black, size: 20),
-                  Text(
-                    widget.winner,
-                    textAlign: TextAlign.center,
-                    style: const TextStyle(
-                      fontWeight: FontWeight.bold,
-                      color: Colors.black87,
-                    ),
-                  ),
-                ],
-              ),
-            ),
-          ),
-        ),
-      ],
-    );
-  }
-}

lib/presentation/widgets/tiles/match_tile.dart

@@ -6,13 +6,13 @@ import 'package:game_tracker/l10n/generated/app_localizations.dart';
 import 'package:game_tracker/presentation/widgets/tiles/text_icon_tile.dart';
 import 'package:intl/intl.dart';
 
-/// A tile widget that displays information about a match, including its name,
-/// creation date, associated group, winner, and players.
-/// - [match]: The match data to be displayed.
-/// - [onTap]: The callback invoked when the tile is tapped.
-/// - [width]: Optional width for the tile.
-/// - [compact]: Whether to display the tile in a compact mode
 class MatchTile extends StatefulWidget {
+  /// A tile widget that displays information about a match, including its name,
+  /// creation date, associated group, winner, and players.
+  /// - [match]: The match data to be displayed.
+  /// - [onTap]: The callback invoked when the tile is tapped.
+  /// - [width]: Optional width for the tile.
+  /// - [compact]: Whether to display the tile in a compact mode
   const MatchTile({
     super.key,
     required this.match,

lib/presentation/widgets/tiles/quick_info_tile.dart

@@ -1,14 +1,14 @@
 import 'package:flutter/material.dart';
 import 'package:game_tracker/core/custom_theme.dart';
 
-/// A tile widget that displays a title with an icon and a numeric value below it.
-/// - [title]: The title text displayed on the tile.
-/// - [icon]: The icon displayed next to the title.
-/// - [value]: The numeric value displayed below the title.
-/// - [height]: Optional height for the tile.
-/// - [width]: Optional width for the tile.
-/// - [padding]: Optional padding for the tile content.
 class QuickInfoTile extends StatefulWidget {
+  /// A tile widget that displays a title with an icon and a numeric value below it.
+  /// - [title]: The title text displayed on the tile.
+  /// - [icon]: The icon displayed next to the title.
+  /// - [value]: The numeric value displayed below the title.
+  /// - [height]: Optional height for the tile.
+  /// - [width]: Optional width for the tile.
+  /// - [padding]: Optional padding for the tile content.
   const QuickInfoTile({
     super.key,
     required this.title,

lib/presentation/widgets/tiles/settings_list_tile.dart

@@ -1,12 +1,12 @@
 import 'package:flutter/material.dart';
 import 'package:game_tracker/core/custom_theme.dart';
 
-/// A customizable settings list tile widget that displays an icon, title, and an optional suffix widget.
-/// - [icon]: The icon displayed on the left side of the tile.
-/// - [title]: The title text displayed next to the icon.
-/// - [suffixWidget]: An optional widget displayed on the right side of the tile.
-/// - [onPressed]: The callback invoked when the tile is tapped.
 class SettingsListTile extends StatelessWidget {
+  /// A customizable settings list tile widget that displays an icon, title, and an optional suffix widget.
+  /// - [icon]: The icon displayed on the left side of the tile.
+  /// - [title]: The title text displayed next to the icon.
+  /// - [suffixWidget]: An optional widget displayed on the right side of the tile.
+  /// - [onPressed]: The callback invoked when the tile is tapped.
   const SettingsListTile({
     super.key,
     required this.icon,

lib/presentation/widgets/tiles/statistics_tile.dart

@@ -4,14 +4,14 @@ import 'package:flutter/material.dart';
 import 'package:game_tracker/l10n/generated/app_localizations.dart';
 import 'package:game_tracker/presentation/widgets/tiles/info_tile.dart';
 
-/// A tile widget that displays statistical data using horizontal bars.
-/// - [icon]: The icon displayed next to the title.
-/// - [title]: The title text displayed on the tile.
-/// - [width]: The width of the tile.
-/// - [values]: A list of tuples containing labels and their corresponding numeric values.
-/// - [itemCount]: The maximum number of items to display.
-/// - [barColor]: The color of the bars representing the values.
 class StatisticsTile extends StatelessWidget {
+  /// A tile widget that displays statistical data using horizontal bars.
+  /// - [icon]: The icon displayed next to the title.
+  /// - [title]: The title text displayed on the tile.
+  /// - [width]: The width of the tile.
+  /// - [values]: A list of tuples containing labels and their corresponding numeric values.
+  /// - [itemCount]: The maximum number of items to display.
+  /// - [barColor]: The color of the bars representing the values.
   const StatisticsTile({
     super.key,
     required this.icon,

lib/presentation/widgets/tiles/text_icon_list_tile.dart

@@ -1,11 +1,11 @@
 import 'package:flutter/material.dart';
 import 'package:game_tracker/core/custom_theme.dart';
 
-/// A list tile widget that displays text with an optional icon button.
-/// - [text]: The text to display in the tile.
-/// - [onPressed]: The callback to be invoked when the icon is pressed.
-/// - [iconEnabled]: A boolean to determine if the icon should be displayed.
 class TextIconListTile extends StatelessWidget {
+  /// A list tile widget that displays text with an optional icon button.
+  /// - [text]: The text to display in the tile.
+  /// - [onPressed]: The callback to be invoked when the icon is pressed.
+  /// - [iconEnabled]: A boolean to determine if the icon should be displayed.
   const TextIconListTile({
     super.key,
     required this.text,

lib/presentation/widgets/tiles/text_icon_tile.dart

@@ -1,11 +1,11 @@
 import 'package:flutter/material.dart';
 import 'package:game_tracker/core/custom_theme.dart';
 
-/// A tile widget that displays text with an optional icon that can be tapped.
-/// - [text]: The text to display in the tile.
-/// - [iconEnabled]: A boolean to determine if the icon should be displayed.
-/// - [onIconTap]: The callback to be invoked when the icon is tapped.
 class TextIconTile extends StatelessWidget {
+  /// A tile widget that displays text with an optional icon that can be tapped.
+  /// - [text]: The text to display in the tile.
+  /// - [iconEnabled]: A boolean to determine if the icon should be displayed.
+  /// - [onIconTap]: The callback to be invoked when the icon is tapped.
   const TextIconTile({
     super.key,
     required this.text,

lib/presentation/widgets/tiles/title_description_list_tile.dart

@@ -1,14 +1,14 @@
 import 'package:flutter/material.dart';
 import 'package:game_tracker/core/custom_theme.dart';
 
-/// A list tile widget that displays a title and description, with optional highlighting and badge.
-/// - [title]: The title text displayed on the tile.
-/// - [description]: The description text displayed below the title.
-/// - [onPressed]: The callback invoked when the tile is tapped.
-/// - [isHighlighted]: A boolean to determine if the tile should be highlighted.
-/// - [badgeText]: Optional text to display in a badge on the right side of the title.
-/// - [badgeColor]: Optional color for the badge background.
 class TitleDescriptionListTile extends StatelessWidget {
+  /// A list tile widget that displays a title and description, with optional highlighting and badge.
+  /// - [title]: The title text displayed on the tile.
+  /// - [description]: The description text displayed below the title.
+  /// - [onPressed]: The callback invoked when the tile is tapped.
+  /// - [isHighlighted]: A boolean to determine if the tile should be highlighted.
+  /// - [badgeText]: Optional text to display in a badge on the right side of the title.
+  /// - [badgeColor]: Optional color for the badge background.
   const TitleDescriptionListTile({
     super.key,
     required this.title,

lib/presentation/widgets/top_centered_message.dart

@@ -1,10 +1,10 @@
 import 'package:flutter/material.dart';
 
-/// A widget that displays a message centered at the top of the screen with an icon, title, and message.
-/// - [icon]: The icon to display above the title.
-/// - [title]: The title text to display.
-/// - [message]: The message text to display below the title.
 class TopCenteredMessage extends StatelessWidget {
+  /// A widget that displays a message centered at the top of the screen with an icon, title, and message.
+  /// - [icon]: The icon to display above the title.
+  /// - [title]: The title text to display.
+  /// - [message]: The message text to display below the title.
   const TopCenteredMessage({
     super.key,
     required this.icon,