diff --git a/lib/presentation/widgets/custom_alert_dialog.dart b/lib/presentation/widgets/custom_alert_dialog.dart
index 2456b56..5dc8b9a 100644
--- a/lib/presentation/widgets/custom_alert_dialog.dart
+++ b/lib/presentation/widgets/custom_alert_dialog.dart
@@ -1,9 +1,19 @@
 import 'package:flutter/material.dart';
 import 'package:game_tracker/core/custom_theme.dart';
 
+/// A custom alert dialog widget that follows the application's design theme.
+///
+/// This widget provides a styled alternative to the default Flutter AlertDialog,
+/// with consistent colors, borders, and layout that match the app's custom theme.
 class CustomAlertDialog extends StatelessWidget {
+  /// The title text displayed at the top of the dialog.
   final String title;
+
+  /// The main content text displayed in the body of the dialog.
   final String content;
+
+  /// A list of action widgets (typically buttons) displayed at the bottom of the dialog.
+  /// These actions are horizontally spaced around the dialog's width.
   final List<Widget> actions;
 
   const CustomAlertDialog({