Prot10 · Prot10 · Jan 25, 2026 · Jan 25, 2026 · Jan 25, 2026 · Jan 25, 2026
diff --git a/README.md b/README.md
@@ -33,7 +33,46 @@ MyMacCleaner is a free, open-source alternative to commercial Mac cleaning apps
 
 ## Screenshots
 
-*Coming soon*
+### Home & Smart Scan
+<p align="center">
+  <img src="website/public/screenshots/home/home_base.png" alt="Home Screen" width="45%">
+  <img src="website/public/screenshots/home/home_full.png" alt="Smart Scan Results" width="45%">
+</p>
+
+### Disk Cleaner & Space Lens
+<p align="center">
+  <img src="website/public/screenshots/disk_cleaner/disk_cleaner_full.png" alt="Disk Cleaner" width="45%">
+  <img src="website/public/screenshots/disk_cleaner/space_lens.png" alt="Space Lens" width="45%">
+</p>
+
+### Performance & System Health
+<p align="center">
+  <img src="website/public/screenshots/performance/performance.png" alt="Performance" width="45%">
+  <img src="website/public/screenshots/system_health/system_health.png" alt="System Health" width="45%">
+</p>
+
+### Applications & Port Management
+<p align="center">
+  <img src="website/public/screenshots/applications/applications_full.png" alt="Applications" width="45%">
+  <img src="website/public/screenshots/port_management/port_managment.png" alt="Port Management" width="45%">
+</p>
+
+### Duplicates & Orphaned Files
+<p align="center">
+  <img src="website/public/screenshots/duplicates/duplicates_full.png" alt="Duplicates" width="45%">
+  <img src="website/public/screenshots/orphaned_files/orphaned_files_full.png" alt="Orphaned Files" width="45%">
+</p>
+
+### Startup Items & Permissions
+<p align="center">
+  <img src="website/public/screenshots/startup_items/startup_items_full.png" alt="Startup Items" width="45%">
+  <img src="website/public/screenshots/permissions/permissions.png" alt="Permissions" width="45%">
+</p>
+
+### Menu Bar Monitor
+<p align="center">
+  <img src="website/public/screenshots/menu/menu.png" alt="Menu Bar" width="30%">
+</p>
 
 ## Requirements
 
@@ -104,13 +143,17 @@ See [Permissions Guide](docs/permissions.md) for detailed information.
 - [Menu Bar Monitor](docs/menu-bar.md)
 - [Permissions Guide](docs/permissions.md)
 
+## Automatic Updates
+
+MyMacCleaner includes built-in automatic update checking powered by the Sparkle framework. The app periodically checks for new versions in the background, and when an update is available, a notification button appears next to the language switcher in the app toolbar. This provides a seamless update experience - simply click the button to download and install the latest version without leaving the app.
+
 ## Tech Stack
 
 - **Language**: Swift 5.9+
 - **UI Framework**: SwiftUI
 - **Design**: Apple Liquid Glass (macOS Tahoe style)
 - **Concurrency**: Swift async/await, TaskGroups
-- **Updates**: Sparkle Framework
+- **Updates**: Sparkle Framework (automatic background checks with in-app notification)
 
 ## Attribution
 

diff --git a/docs/applications.md b/docs/applications.md
@@ -2,6 +2,9 @@
 
 Complete application management: uninstall apps properly and check for updates.
 
+![Applications - Before Analysis](/MyMacCleaner/screenshots/applications/applications_base.png)
+*Applications Manager ready to analyze your installed apps*
+
 ## Overview
 
 The Applications Manager helps you:
@@ -12,6 +15,9 @@ The Applications Manager helps you:
 
 ## Application List
 
+![Applications - Full List](/MyMacCleaner/screenshots/applications/applications_full.png)
+*Grid view showing all installed applications with size and update status*
+
 ### Views
 
 - **Grid View** - Visual display with app icons
@@ -85,6 +91,10 @@ MyMacCleaner scans for all related files before uninstalling.
 
 ## Update Checker
 
+### Automatic Update Notifications
+
+MyMacCleaner itself automatically checks for updates in the background using the Sparkle framework. When a new version is available, an update notification button appears next to the language switcher in the app toolbar. This seamless experience lets you update the app without interrupting your workflow - simply click the button to download and install the latest version.
+
 ### Supported Update Sources
 
 | Source | Detection Method |

diff --git a/docs/disk-cleaner.md b/docs/disk-cleaner.md
@@ -2,10 +2,16 @@
 
 Deep cleaning functionality to remove junk files and free up disk space.
 
+![Disk Cleaner - Before Scan](/MyMacCleaner/screenshots/disk_cleaner/disk_cleaner_base.png)
+*Disk Cleaner ready to scan for junk files*
+
 ## Overview
 
 Disk Cleaner provides granular control over what gets cleaned, with detailed categories and safe deletion practices.
 
+![Disk Cleaner - Scan Results](/MyMacCleaner/screenshots/disk_cleaner/disk_cleaner_full.png)
+*Detailed scan results showing all cleanable categories*
+
 ## Categories
 
 ### System Junk
@@ -59,6 +65,9 @@ Web browser caches and data.
 
 The Browser Privacy tab provides deep cleaning of browser data for enhanced privacy.
 
+![Browser Privacy](/MyMacCleaner/screenshots/disk_cleaner/privacy.png)
+*Browser Privacy tab for deep cleaning browser data*
+
 ### Supported Browsers
 
 | Browser | Supported |

diff --git a/docs/duplicates.md b/docs/duplicates.md
@@ -2,10 +2,16 @@
 
 Find and remove duplicate files to reclaim wasted disk space.
 
+![Duplicates - Before Scan](/MyMacCleaner/screenshots/duplicates/duplicates_base.png)
+*Duplicate Finder ready to scan for duplicate files*
+
 ## Overview
 
 The Duplicate Finder scans your folders for exact duplicate files using SHA256 hashing. It identifies files with identical content regardless of their names or locations, helping you safely remove redundant copies.
 
+![Duplicates - Results](/MyMacCleaner/screenshots/duplicates/duplicates_full.png)
+*Scan results showing duplicate file groups with statistics*
+
 ## How It Works
 
 The scanner uses a multi-stage process optimized for speed and accuracy:

diff --git a/docs/home.md b/docs/home.md
@@ -2,6 +2,9 @@
 
 The Home screen is your dashboard for quick system overview and one-click cleanup.
 
+![Home Screen - Before Scan](/MyMacCleaner/screenshots/home/home_base.png)
+*Home screen with Smart Scan ready to analyze your system*
+
 ## Overview
 
 When you open MyMacCleaner, the Home screen provides:
@@ -49,6 +52,9 @@ After scanning, you'll see:
 - Individual items you can select/deselect
 - Safety indicators for each item
 
+![Home Screen - After Scan](/MyMacCleaner/screenshots/home/home_full.png)
+*Scan results showing cleanable categories and total space to recover*
+
 ## Quick Actions
 
 Shortcuts to common tasks:

diff --git a/docs/menu-bar.md b/docs/menu-bar.md
@@ -2,6 +2,9 @@
 
 Monitor your Mac's performance at a glance from the menu bar.
 
+![Menu Bar](/MyMacCleaner/screenshots/menu/menu.png)
+*Menu Bar popover showing CPU, Memory, and Disk stats with quick actions*
+
 ## Overview
 
 The Menu Bar Monitor provides real-time CPU and RAM monitoring directly in your menu bar. Click to see detailed stats and quick actions without opening the full app.

diff --git a/docs/orphaned-files.md b/docs/orphaned-files.md
@@ -2,10 +2,16 @@
 
 Detect and remove leftover files from applications that have been uninstalled.
 
+![Orphaned Files - Before Scan](/MyMacCleaner/screenshots/orphaned_files/orphaned_files_base.png)
+*Orphaned Files scanner ready to detect leftover files*
+
 ## Overview
 
 When you delete an application by dragging it to the Trash, many associated files remain on your system. These "orphaned files" can accumulate over time, taking up valuable disk space. The Orphaned Files scanner identifies these remnants and helps you safely remove them.
 
+![Orphaned Files - Results](/MyMacCleaner/screenshots/orphaned_files/orphaned_files_full.png)
+*Scan results showing orphaned files grouped by category*
+
 ## What Are Orphaned Files?
 
 Orphaned files are support files that were created by applications but remain after the app is uninstalled. They include:

diff --git a/docs/performance.md b/docs/performance.md
@@ -2,6 +2,9 @@
 
 System optimization tools and maintenance tasks.
 
+![Performance](/MyMacCleaner/screenshots/performance/performance.png)
+*Performance dashboard showing memory usage, processes, and maintenance options*
+
 ## Overview
 
 The Performance section provides tools to optimize your Mac's speed and responsiveness through memory management and system maintenance.

diff --git a/docs/permissions.md b/docs/permissions.md
@@ -2,6 +2,9 @@
 
 Understanding and managing permissions for MyMacCleaner.
 
+![Permissions](/MyMacCleaner/screenshots/permissions/permissions.png)
+*Permissions management page showing folder access status*
+
 ## Overview
 
 MyMacCleaner needs certain permissions to access system files and perform cleanup operations. This guide explains what permissions are needed, why, and how to grant them.

diff --git a/docs/port-management.md b/docs/port-management.md
@@ -2,6 +2,9 @@
 
 View and manage processes using network ports.
 
+![Port Management](/MyMacCleaner/screenshots/port_management/port_managment.png)
+*Port Management showing active network connections and listening ports*
+
 ## Overview
 
 Port Management helps developers and power users see what's running on their Mac's network ports and terminate processes when needed.

diff --git a/docs/space-lens.md b/docs/space-lens.md
@@ -2,6 +2,9 @@
 
 Visual disk space analyzer with interactive treemap visualization.
 
+![Space Lens](/MyMacCleaner/screenshots/disk_cleaner/space_lens.png)
+*Interactive treemap visualization showing disk usage by folder and file*
+
 ## Overview
 
 Space Lens helps you understand where your disk space is going through an intuitive visual representation. Find large files and folders at a glance.

diff --git a/docs/startup-items.md b/docs/startup-items.md
@@ -2,10 +2,16 @@
 
 Manage applications and services that launch automatically when you log in.
 
+![Startup Items - Before Scan](/MyMacCleaner/screenshots/startup_items/startup_items_base.png)
+*Startup Items ready to discover login items and launch agents*
+
 ## Overview
 
 Startup Items helps you control what runs when your Mac starts, improving boot time and reducing resource usage.
 
+![Startup Items - Full List](/MyMacCleaner/screenshots/startup_items/startup_items_full.png)
+*Complete list of startup items with enable/disable controls*
+
 ## Quick Stats
 
 The dashboard shows four key metrics:

diff --git a/docs/system-health.md b/docs/system-health.md
@@ -2,6 +2,9 @@
 
 Monitor your Mac's overall health with a comprehensive health score and detailed system information.
 
+![System Health](/MyMacCleaner/screenshots/system_health/system_health.png)
+*System Health dashboard showing health score gauge and system information*
+
 ## Overview
 
 System Health provides an at-a-glance view of your Mac's condition through a health score gauge, individual health checks, and detailed system information.

diff --git a/website/public/screenshots/duplicates/duplicates_full.png b/website/public/screenshots/duplicates/duplicates_full.png