Onboarding Enhancement

DynamicIsland/DynamicIslandApp.swift

@@ -447,7 +447,8 @@ class AppDelegate: NSObject, NSApplicationDelegate {
             if change.newValue == true && Defaults[.sneakPeekStyles] != .standard {
                 Defaults[.sneakPeekStyles] = .standard
             }
-            self?.debouncedUpdateWindowSize()
+            // Update window size IMMEDIATELY (no debouncing) to prevent position shift
+            self?.updateWindowSizeIfNeeded()
         }.store(in: &cancellables)
         
         // Observe screen recording settings changes

DynamicIsland/Localizable.xcstrings

@@ -312,6 +312,10 @@
     },
     "Choose your preferred AI model and configuration" : {
 
+    },
+    "Choose Your Profile" : {
+      "comment" : "A title displayed above the list of profile selection options.",
+      "isCommentAutoGenerated" : true
     },
     "Circle" : {
 
@@ -819,9 +823,6 @@
           }
         }
       }
-    },
-    "Media change with horizontal gestures" : {
-
     },
     "Media controls" : {
 
@@ -1114,6 +1115,10 @@
       "comment" : "The title of the privacy and security settings screen.",
       "isCommentAutoGenerated" : true
     },
+    "Privacy Policy" : {
+      "comment" : "A link to the privacy policy.",
+      "isCommentAutoGenerated" : true
+    },
     "Progress bar" : {
       "localizations" : {
         "en" : {
@@ -1264,6 +1269,10 @@
     },
     "Select Calendars" : {
 
+    },
+    "Select one or more profiles to customize your experience" : {
+      "comment" : "A description below the header that instructs users to select one or more profiles to customize their experience.",
+      "isCommentAutoGenerated" : true
     },
     "Select the music source you want to use. You can change this later in the app settings." : {
 
@@ -1519,8 +1528,9 @@
     "Try different search terms" : {
 
     },
-    "Two-finger swipe up on notch to close, two-finger swipe down on notch to open when **Open notch on hover** option is disabled" : {
+    "Two-finger swipe up on notch to close, two-finger swipe down on notch to open when **Open notch on hover** option is disabled. Two-finger horizontal swipes to control media playback" : {
-
+      "comment" : "A footer text describing the gesture controls in the settings view.",
+      "isCommentAutoGenerated" : true
     },
     "UI Mode" : {
 

DynamicIsland/components/Onboarding/OnboardingFinishView.swift

@@ -45,6 +45,19 @@ struct OnboardingFinishView: View {
                     .buttonStyle(.borderedProminent)
                     .controlSize(.large)
                     .keyboardShortcut(.defaultAction)
+                
+                // Privacy Policy Link
+                Button(action: {
+                    if let url = URL(string: "https://ebullioscopic.github.io/DynamicIsland/privacy-policy") {
+                        NSWorkspace.shared.open(url)
+                    }
+                }) {
+                    Text("Privacy Policy")
+                        .font(.caption)
+                        .foregroundColor(.secondary)
+                }
+                .buttonStyle(.plain)
+                .padding(.top, 4)
             }
             .padding(24)
         }

DynamicIsland/components/Onboarding/OnboardingView.swift

@@ -13,6 +13,7 @@ enum OnboardingStep {
     case cameraPermission
     case calendarPermission
     case musicPermission
+    case profileSelection
     case finished
 }
 
@@ -81,6 +82,17 @@ struct OnboardingView: View {
             case .musicPermission:
                 MusicControllerSelectionView(
                     onContinue: {
+                        withAnimation(.easeInOut(duration: 0.6)) {
+                            step = .profileSelection
+                        }
+                    }
+                )
+                .transition(.opacity)
+                
+            case .profileSelection:
+                ProfileSelectionView(
+                    onContinue: { profiles in
+                        applyProfileSettings(profiles)
                         withAnimation(.easeInOut(duration: 0.6)) {
                             step = .finished
                         }
@@ -105,3 +117,4 @@ struct OnboardingView: View {
         await calendarService.requestAccess()
     }
 }
+

DynamicIsland/components/Onboarding/ProfileSelectionView.swift

@@ -0,0 +1,260 @@
+//
+//  ProfileSelectionView.swift
+//  DynamicIsland
+//
+//  Created on 2025-10-05.
+//
+
+import SwiftUI
+import Defaults
+
+struct UserProfile: Identifiable, Hashable {
+    let id: String
+    let name: String
+    let icon: String
+    let description: String
+    let gradient: [Color]
+}
+
+struct ProfileSelectionView: View {
+    @State private var selectedProfiles: Set<String> = []
+    let onContinue: (Set<String>) -> Void
+    
+    let profiles: [UserProfile] = [
+        UserProfile(
+            id: "developer",
+            name: "Developer",
+            icon: "terminal.fill",
+            description: "Code and debug with color picker, stats monitoring, and screen assistant.",
+            gradient: [Color.blue, Color.purple]
+        ),
+        UserProfile(
+            id: "designer",
+            name: "Designer",
+            icon: "paintbrush.fill",
+            description: "Create and design with color picker, mirror, and visual effects.",
+            gradient: [Color.pink, Color.orange]
+        ),
+        UserProfile(
+            id: "lightuse",
+            name: "Light Use",
+            icon: "sparkles",
+            description: "Simple and minimal interface with just the essentials for everyday tasks.",
+            gradient: [Color.green, Color.mint]
+        ),
+        UserProfile(
+            id: "student",
+            name: "Student",
+            icon: "book.fill",
+            description: "Stay organized with calendar, timer, and battery monitoring.",
+            gradient: [Color.indigo, Color.cyan]
+        )
+    ]
+    
+    var body: some View {
+        VStack(spacing: 24) {
+            // Header
+            VStack(spacing: 8) {
+                Image(systemName: "person.3.fill")
+                    .font(.system(size: 50))
+                    .foregroundStyle(.linearGradient(colors: [.blue, .purple], startPoint: .topLeading, endPoint: .bottomTrailing))
+                    .padding(.bottom, 8)
+                
+                Text("Choose Your Profile")
+                    .font(.largeTitle)
+                    .fontWeight(.bold)
+                
+                Text("Select one or more profiles to customize your experience")
+                    .font(.body)
+                    .foregroundColor(.secondary)
+                    .multilineTextAlignment(.center)
+                    .padding(.horizontal, 40)
+            }
+            .padding(.top, 20)
+            
+            // Profile Grid
+            LazyVGrid(columns: [GridItem(.flexible()), GridItem(.flexible())], spacing: 16) {
+                ForEach(profiles) { profile in
+                    ProfileCard(
+                        profile: profile,
+                        isSelected: selectedProfiles.contains(profile.id),
+                        onTap: {
+                            toggleProfile(profile.id)
+                        }
+                    )
+                }
+            }
+            .padding(.horizontal, 24)
+            
+            Spacer()
+            
+            // Continue Button
+            Button(action: {
+                if !selectedProfiles.isEmpty {
+                    onContinue(selectedProfiles)
+                }
+            }) {
+                Text("Continue")
+                    .frame(maxWidth: .infinity)
+                    .padding(.vertical, 12)
+            }
+            .buttonStyle(.borderedProminent)
+            .disabled(selectedProfiles.isEmpty)
+            .padding(.horizontal, 24)
+            .padding(.bottom, 24)
+        }
+        .frame(maxWidth: .infinity, maxHeight: .infinity)
+        .background(
+            VisualEffectView(material: .underWindowBackground, blendingMode: .behindWindow)
+                .ignoresSafeArea()
+        )
+    }
+    
+    private func toggleProfile(_ profileId: String) {
+        withAnimation(.spring(response: 0.3, dampingFraction: 0.7)) {
+            if selectedProfiles.contains(profileId) {
+                selectedProfiles.remove(profileId)
+            } else {
+                selectedProfiles.insert(profileId)
+            }
+        }
+    }
+}
+
+struct ProfileCard: View {
+    let profile: UserProfile
+    let isSelected: Bool
+    let onTap: () -> Void
+    
+    @State private var isHovering = false
+    
+    var body: some View {
+        Button(action: onTap) {
+            VStack(alignment: .leading, spacing: 12) {
+                HStack {
+                    Image(systemName: profile.icon)
+                        .font(.system(size: 28))
+                        .foregroundStyle(.linearGradient(colors: profile.gradient, startPoint: .topLeading, endPoint: .bottomTrailing))
+                    
+                    Spacer()
+                    
+                    if isSelected {
+                        Image(systemName: "checkmark.circle.fill")
+                            .font(.system(size: 22))
+                            .foregroundStyle(.linearGradient(colors: profile.gradient, startPoint: .topLeading, endPoint: .bottomTrailing))
+                            .transition(.scale.combined(with: .opacity))
+                    }
+                }
+                
+                Text(profile.name)
+                    .font(.headline)
+                    .fontWeight(.semibold)
+                    .foregroundColor(.primary)
+                
+                Text(profile.description)
+                    .font(.caption)
+                    .foregroundColor(.secondary)
+                    .lineLimit(3)
+                    .fixedSize(horizontal: false, vertical: true)
+            }
+            .padding(16)
+            .frame(height: 160)
+            .background(
+                RoundedRectangle(cornerRadius: 16)
+                    .fill(isSelected ? 
+                          LinearGradient(colors: profile.gradient.map { $0.opacity(0.15) }, startPoint: .topLeading, endPoint: .bottomTrailing) :
+                          LinearGradient(colors: [Color.gray.opacity(0.1)], startPoint: .topLeading, endPoint: .bottomTrailing)
+                    )
+            )
+            .overlay(
+                RoundedRectangle(cornerRadius: 16)
+                    .strokeBorder(
+                        isSelected ? 
+                        LinearGradient(colors: profile.gradient, startPoint: .topLeading, endPoint: .bottomTrailing) :
+                        LinearGradient(colors: [Color.clear], startPoint: .topLeading, endPoint: .bottomTrailing),
+                        lineWidth: isSelected ? 2 : 0
+                    )
+            )
+            .scaleEffect(isHovering ? 1.02 : 1.0)
+            .shadow(color: isSelected ? profile.gradient[0].opacity(0.3) : .clear, radius: 8, x: 0, y: 4)
+        }
+        .buttonStyle(.plain)
+        .onHover { hovering in
+            withAnimation(.easeInOut(duration: 0.2)) {
+                isHovering = hovering
+            }
+        }
+    }
+}
+
+// MARK: - Profile Settings Configuration
+
+func applyProfileSettings(_ profiles: Set<String>) {
+    // Clipboard is ALWAYS enabled (per user request)
+    Defaults[.enableClipboardManager] = true
+    
+    // Developer Profile Settings
+    let isDeveloper = profiles.contains("developer")
+    if isDeveloper {
+        Defaults[.enableColorPickerFeature] = true
+        Defaults[.enableStatsFeature] = true
+        Defaults[.enableTimerFeature] = true
+        Defaults[.enableScreenAssistant] = true
+        Defaults[.showMirror] = false
+        Defaults[.enableMinimalisticUI] = false
+    }
+    
+    // Designer Profile Settings
+    let isDesigner = profiles.contains("designer")
+    if isDesigner {
+        Defaults[.enableColorPickerFeature] = true
+        Defaults[.showMirror] = true
+        Defaults[.lightingEffect] = true
+        Defaults[.inlineHUD] = true
+        Defaults[.enableStatsFeature] = false
+        Defaults[.enableTimerFeature] = false
+        Defaults[.enableMinimalisticUI] = false
+        Defaults[.enableScreenAssistant] = false
+    }
+    
+    // Light Use Profile Settings
+    let isLightUse = profiles.contains("lightuse")
+    if isLightUse {
+        Defaults[.enableMinimalisticUI] = true
+        Defaults[.enableColorPickerFeature] = false
+        Defaults[.showMirror] = false
+        Defaults[.enableStatsFeature] = false
+        Defaults[.enableTimerFeature] = true
+        Defaults[.inlineHUD] = false
+        Defaults[.enableScreenAssistant] = false
+    }
+    
+    // Student Profile Settings
+    let isStudent = profiles.contains("student")
+    if isStudent {
+        Defaults[.enableTimerFeature] = true
+        Defaults[.showCalendar] = true
+        Defaults[.enableColorPickerFeature] = false
+        Defaults[.showMirror] = false
+        Defaults[.enableStatsFeature] = false
+        Defaults[.enableMinimalisticUI] = false
+        Defaults[.enableScreenAssistant] = false
+    }
+    
+    // If Light Use is NOT selected but others are, ensure minimalistic is OFF
+    if !isLightUse && !profiles.isEmpty {
+        Defaults[.enableMinimalisticUI] = false
+    }
+    
+    // Common settings for all profiles
+    Defaults[.menubarIcon] = true
+    Defaults[.enableHaptics] = true
+    
+    print("✅ Applied profile settings for: \(profiles.joined(separator: ", "))")
+}
+
+#Preview {
+    ProfileSelectionView(onContinue: { profiles in
+        print("Selected profiles: \(profiles)")
+    })
+}

DynamicIsland/components/Onboarding/WelcomeView.swift

@@ -58,6 +58,19 @@ struct WelcomeView: View {
                             .padding(.vertical, 6)
                     }
                     .buttonStyle(BorderedProminentButtonStyle())
+                    
+                    // Privacy Policy Link
+                    Button(action: {
+                        if let url = URL(string: "https://ebullioscopic.github.io/DynamicIsland/privacy-policy") {
+                            NSWorkspace.shared.open(url)
+                        }
+                    }) {
+                        Text("Privacy Policy")
+                            .font(.caption)
+                            .foregroundColor(.secondary)
+                    }
+                    .buttonStyle(.plain)
+                    .padding(.top, 8)
                 }
                 .padding(.top)
             }

DynamicIsland/models/Constants.swift

@@ -248,6 +248,7 @@ extension Defaults.Keys {
         // MARK: Gestures
     static let enableGestures = Key<Bool>("enableGestures", default: true)
     static let closeGestureEnabled = Key<Bool>("closeGestureEnabled", default: true)
+    static let enableMediaGestures = Key<Bool>("enableMediaGestures", default: true)
     static let gestureSensitivity = Key<CGFloat>("gestureSensitivity", default: 200.0)
     
         // MARK: Media playback

ONBOARDING_ENHANCEMENT.md

@@ -0,0 +1,184 @@
+# Onboarding Enhancement - User Profile Selection
+
+## Overview
+Added comprehensive user profile selection to the onboarding flow, allowing users to customize their DynamicIsland experience based on their work type.
+
+## What Was Changed
+
+### 1. New Files Created
+
+#### `ProfileSelectionView.swift`
+- **Location**: `DynamicIsland/components/Onboarding/ProfileSelectionView.swift`
+- **Features**:
+  - Multi-select card interface with 4 user profiles
+  - Beautiful gradient cards with hover effects
+  - Profile-specific settings configuration
+  - At least one profile must be selected to continue
+
+#### `reset_app_defaults.sh`
+- **Location**: Root directory
+- **Purpose**: Reset app to factory defaults for testing
+- **Usage**: `./reset_app_defaults.sh`
+
+### 2. Modified Files
+
+#### `OnboardingView.swift`
+- Added `profileSelection` step to `OnboardingStep` enum
+- Integrated `ProfileSelectionView` before finish screen
+- Added profile settings application logic
+
+#### `WelcomeView.swift`
+- Added "Privacy Policy" link button
+- Links to: `https://ebullioscopic.github.io/DynamicIsland/privacy-policy`
+
+#### `OnboardingFinishView.swift`
+- Added "Privacy Policy" link button
+
+## User Profiles
+
+### 🔧 Developer
+**For**: Developers and programmers
+**Enables**:
+- ✅ Color Picker
+- ✅ Stats Monitoring
+- ✅ Timer
+- ✅ Screen Assistant
+- ❌ Mirror (disabled)
+- ❌ Minimalistic UI (disabled)
+
+**Note**: Clipboard is always enabled for all profiles
+
+### 🎨 Designer
+**For**: Graphic designers and creatives
+**Enables**:
+- ✅ Color Picker
+- ✅ Mirror
+- ✅ Lighting Effects
+- ✅ Inline HUD
+- ❌ Stats (disabled)
+- ❌ Timer (disabled)
+- ❌ Screen Assistant (disabled)
+- ❌ Minimalistic UI (disabled)
+
+**Note**: Clipboard is always enabled for all profiles
+
+### ✨ Light Use
+**For**: Minimal everyday use
+**Enables**:
+- ✅ Minimalistic UI (simplified interface)
+- ✅ Timer
+- ❌ All other advanced features disabled
+
+**Note**: Clipboard is always enabled for all profiles
+
+### 📚 Student
+**For**: Students and learners
+**Enables**:
+- ✅ Timer
+- ✅ Calendar
+- ✅ Battery Monitoring
+- ❌ Color Picker (disabled)
+- ❌ Mirror (disabled)
+- ❌ Stats (disabled)
+- ❌ Screen Assistant (disabled)
+- ❌ Minimalistic UI (disabled)
+
+**Note**: Clipboard is always enabled for all profiles
+
+## Multi-Select Logic
+
+- Users can select **one or more** profiles
+- Settings use **OR logic**: If ANY selected profile enables a feature, it's enabled
+- **Exception**: Minimalistic UI is only enabled if "Light Use" is selected AND no other profiles are selected
+- Common settings (menubar icon, haptics) enabled for all profiles
+
+## Privacy Policy Integration
+
+- Links added to Welcome and Finish screens
+- Opens in default browser
+- URL: `https://ebullioscopic.github.io/DynamicIsland/privacy-policy`
+- **Note**: You need to create this page on GitHub Pages
+
+## Reset Script Usage
+
+To test the onboarding flow fresh:
+
+```bash
+# Run the reset script
+./reset_app_defaults.sh
+
+# The script will:
+# 1. Kill the app if running
+# 2. Clear UserDefaults
+# 3. Remove Application Support files
+# 4. Remove caches
+# 5. Remove preference files
+# 6. Remove saved state
+
+# Then launch the app
+open -a DynamicIsland
+```
+
+## Updated Onboarding Flow
+
+**New Flow**:
+1. Welcome Screen (with Privacy Policy link)
+2. Camera Permission
+3. Calendar Permission
+4. Music Controller Selection
+5. **✨ Profile Selection** (NEW!)
+6. Finish Screen (with Privacy Policy link)
+
+## Testing Checklist
+
+- [ ] Profile cards display correctly
+- [ ] Multi-select works (can select/deselect profiles)
+- [ ] Cannot continue without selecting at least one profile
+- [ ] Hover effects work on profile cards
+- [ ] Settings are applied correctly for each profile combination
+- [ ] Privacy Policy links open correct URL
+- [ ] Reset script clears all app data
+- [ ] Onboarding shows on fresh launch after reset
+- [ ] Selected profile settings persist after closing onboarding
+
+## Profile Settings Matrix
+
+| Setting | Developer | Designer | Light Use | Student | Always Enabled |
+|---------|-----------|----------|-----------|---------|----------------|
+| **Clipboard** | ✅ | ✅ | ✅ | ✅ | **YES** |
+| Minimalistic UI | OFF | OFF | **ON** | OFF | - |
+| Color Picker | **ON** | **ON** | OFF | OFF | - |
+| Mirror | OFF | **ON** | OFF | OFF | - |
+| Stats | **ON** | OFF | OFF | OFF | - |
+| Timer | **ON** | OFF | **ON** | **ON** | - |
+| Screen Assistant | **ON** | OFF | OFF | OFF | - |
+| Lighting Effects | - | **ON** | - | - | - |
+| Inline HUD | - | **ON** | OFF | - | - |
+| Calendar | - | - | - | **ON** | - |
+
+**Note**: Clipboard Manager is always enabled regardless of profile selection.
+
+## Next Steps
+
+1. **Create GitHub Pages Privacy Policy**:
+   - Create `docs/privacy-policy.md` in the repository
+   - Enable GitHub Pages for the repo
+   - Add actual privacy policy content
+
+2. **Test All Profile Combinations**:
+   - Single profiles (4 tests)
+   - Common combinations (Developer+Designer, etc.)
+   - All profiles selected
+
+3. **Verify Settings Integration**:
+   - Check that disabled features don't appear in UI
+   - Verify minimalistic mode works correctly
+   - Test feature toggles in settings
+
+## Implementation Notes
+
+- Profile selection is **required** (cannot skip)
+- Settings are applied immediately when continuing
+- Profile data is stored in UserDefaults
+- Reset script is safe - only clears app-specific data
+- All UI uses SwiftUI with proper transitions and animations

ReadMe.md

@@ -56,6 +56,9 @@
 - **Audio Visualizer**: Dynamic spectrum visualization with color adaptation
 - **Multi-Platform Support**: Apple Music, Spotify, YouTube Music, and more
 - **Smooth Transitions**: Elegant animations between tracks and states
+- **Minimalistic Mode**: Streamlined 420px compact layout for essential controls
+- **Lighting Effects**: Beautiful album art glow effects with player tinting
+- **Sneak Peek**: Standard and inline preview modes for quick glances
 
 ### 📊 Advanced System Monitoring
 - **CPU, Memory, GPU, Network, Disk**: Real-time stats with live graphs
@@ -63,8 +66,9 @@
 - **Intelligent Layout**: Vertical expansion, 1-5 graph layouts, perfect centering
 - **Customizable Visibility**: Toggle individual graphs on/off
 - **Smooth Animations**: Debounced updates for fluid transitions
+- **Stats Panel**: Floating window with detailed system metrics
 
-### 🎨 ColorPicker (NEW!)
+### 🎨 ColorPicker
 <div align="center">
    <img src="https://github.com/Ebullioscopic/DynamicIsland/blob/main/DynamicIslandSamples/colorpickerpanel.png" alt="ColorPicker Panel" width="350"/>
    <br>
@@ -72,10 +76,43 @@
 </div>
 
 - **Screen Color Picking**: Raycast-inspired panel, real-time magnification
-- **Multiple Formats**: HEX, RGB, HSL, SwiftUI, UIColor, and more
+- **Multiple Formats**: HEX, RGB, HSL, SwiftUI, UIColor, NSColor, CSS, and more
 - **History & Quick Copy**: Recent colors, hover info, click to copy
 - **Global Shortcut**: Cmd+Shift+P (customizable)
-- **Settings Integration**: Enable/disable, customize controls
+- **Panel & Popover Modes**: Choose between floating panel or integrated popover
+- **Settings Integration**: Full control over features and appearance
+
+### 📋 Clipboard Manager
+<div align="center">
+   <img src="https://github.com/Ebullioscopic/DynamicIsland/blob/main/DynamicIslandSamples/clipboardpanel.png" alt="Clipboard Panel" width="350"/>
+   <br>
+   <img src="https://github.com/Ebullioscopic/DynamicIsland/blob/main/DynamicIslandSamples/clipboardpopover.png" alt="Clipboard Popover" width="350"/>
+</div>
+
+- **Clipboard History**: Access recent clipboard items with thumbnails
+- **Panel & Popover**: Dual display modes for flexible access
+- **Always Active**: Clipboard monitoring enabled by default
+- **Quick Access**: Click to copy, keyboard shortcuts for rapid paste
+
+### 🧠 Screen Assistant
+- **AI-Powered Analysis**: Intelligent screen content understanding
+- **Panel & Popover Modes**: Flexible display options
+- **Context-Aware**: Smart suggestions based on screen content
+- **Keyboard Shortcut**: Quick access to screen analysis
+
+### ✨ Minimalistic Mode (NEW!)
+- **Compact Layout**: 420px width (vs 640px normal)
+- **Essential Features Only**: Music controls, HUDs, timer - no clutter
+- **Perfect for Light Use**: Minimal interface for everyday tasks
+- **Auto-Configuration**: Profile-based setup during onboarding
+- **Smooth Transitions**: Seamless switching between modes
+
+### 🎯 Smart Onboarding (NEW!)
+- **User Profiles**: Developer, Designer, Light Use, Student
+- **Multi-Select**: Choose multiple profiles for combined features
+- **Auto-Configuration**: Settings applied based on selected profiles
+- **Privacy Policy**: Integrated privacy policy links
+- **Guided Setup**: Camera, calendar, music permissions with clear explanations
 
 ### ⏱️ Timer & Productivity
 - **Multiple Timers**: Create/manage named timers
@@ -96,23 +133,41 @@
 - **Perfect Alignment**: Maintains center positioning across all states
 
 ### 🗂️ Widgets & Panels
-<div align="center">
+- **Multiple Panel Modes**: Floating panels and integrated popovers
-   <img src="https://github.com/Ebullioscopic/DynamicIsland/blob/main/DynamicIslandSamples/clipboardpanel.png" alt="Clipboard Panel" width="350"/>
+- **Clipboard Manager**: Quick access to recent clipboard items (always enabled)
-   <br>
+- **Screen Assistant**: AI-powered screen content analysis
-   <img src="https://github.com/Ebullioscopic/DynamicIsland/blob/main/DynamicIslandSamples/clipboardpopover.png" alt="Clipboard Popover" width="350"/>
+- **ColorPicker**: Professional color picking tool
-</div>
+- **Stats Panel**: Floating system monitoring window
-
-- **Clipboard Manager**: Quick access to recent clipboard items
 - **Weather Widget**: Displays current weather (location access required)
+- **Calendar Integration**: View upcoming events and schedules
 - **App Switcher**: Swipe gestures for fast app switching
 
+### ⌨️ Keyboard Shortcuts
+- **Toggle Notch**: Customizable shortcut to open/close DynamicIsland
+- **Clipboard Panel**: Quick access to clipboard history
+- **ColorPicker**: Instant color picker activation (Cmd+Shift+P)
+- **Screen Assistant**: AI analysis shortcut
+- **Stats Panel**: Toggle system monitoring window
+- **Demo Timer**: Start 5-minute demo timer
+- **Sneak Peek**: Quick preview toggle
+- **Fully Customizable**: All shortcuts can be remapped
+
+### 🎨 Customization & Theming
+- **Minimalistic Mode**: Toggle between full-featured and minimal layouts
+- **Corner Radius Scaling**: Adjust notch roundness
+- **Lighting Effects**: Album art glow and player tinting
+- **Shadow Effects**: Customize drop shadows
+- **Mirror Feature**: Quick camera preview
+- **Custom Animations**: Modern or classic close animations
+- **Profile-Based Setup**: Auto-configure based on use case
+
 ---
 
 ## 🚀 Getting Started
 
 ### Prerequisites
 - **macOS Sonoma 14.0+** (Optimized for Sequoia 15.0+)
-- **MacBook with Notch** (Pro 14"/16" M1/M2/M3 series)
+- **MacBook with Notch** (Pro 14"/16" M1/M2/M3/M4 series)
 - **Xcode 15.0+**, **Swift 5.9+**
 - **Admin privileges** for system monitoring features
 
@@ -122,9 +177,33 @@ git clone https://github.com/Ebullioscopic/DynamicIsland.git
 cd DynamicIsland
 open DynamicIsland.xcodeproj
 ```
-1. Enable **Accessibility**, **Screen Recording**, and **Full Disk Access** in System Settings
+1. Build and run in Xcode (`Cmd + R`)
-2. Build and run in Xcode (`Cmd + R`)
+2. **First Launch Onboarding**:
-3. The app will appear in your menu bar and activate the notch
+   - Choose your profile(s): Developer, Designer, Light Use, or Student
+   - Grant permissions: Camera (for mirror), Calendar, Music
+   - Settings auto-configured based on your selection
+3. Enable **Accessibility** for advanced features (ColorPicker, Screen Assistant)
+4. The app will appear in your menu bar and activate the notch
+
+### Quick Start Profiles
+
+**🔧 Developer**
+- ColorPicker, Stats, Screen Assistant, Timer enabled
+- Full feature set for coding workflows
+
+**🎨 Designer**
+- ColorPicker, Mirror, Lighting Effects enabled
+- Visual-focused tools and aesthetics
+
+**✨ Light Use**
+- Minimalistic Mode (420px compact layout)
+- Essential features only: Music, HUDs, Timer
+
+**📚 Student**
+- Calendar, Timer, Clipboard enabled
+- Organization-focused feature set
+
+**Note**: Clipboard Manager is always enabled regardless of profile selection.
 
 ---
 
@@ -134,44 +213,129 @@ open DynamicIsland.xcodeproj
 - **Hover to Activate**: Move cursor near the notch to expand
 - **Click to Open**: Tap the notch area for full controls
 - **Gesture Support**: Swipe down to expand, swipe up to close
-- **Tab Navigation**: Switch between Home, Shelf, Timer, Stats, ColorPicker, and more
+- **Tab Navigation**: Switch between Home, Stats, Timer, and more
+
+### First Time Setup
+1. **Choose Your Profile**: Select Developer, Designer, Light Use, or Student
+2. **Grant Permissions**: Camera, Calendar, Music access as needed
+3. **Enable Accessibility**: For ColorPicker and Screen Assistant (optional)
+4. **Customize**: Visit Settings to fine-tune features
+
+### Music & Media
+- **Now Playing**: Album art, track info, playback controls
+- **Visualizer**: Real-time audio spectrum (enable in Settings)
+- **Minimalistic Mode**: Compact 420px layout for essential controls
+- **Sneak Peek**: Quick preview without fully opening
 
 ### System Monitoring
 - **Stats Tab**: CPU, Memory, GPU, Network, Disk with live graphs
-- **Layout Intelligence**: 1-3 graphs in a row, 4 in 2×2 grid, 5 in 3+2 layout
+- **Layout Intelligence**: 1-3 graphs in a row, 4+ in grid layout
+- **Stats Panel**: Floating window for persistent monitoring
 - **Smooth Transitions**: Animated layout changes, perfect centering
 
 ### ColorPicker
-- **Panel & Popover**: Pick colors anywhere, see recent colors, copy formats
+- **Quick Access**: Cmd+Shift+P or from tab navigation
-- **Shortcut**: Cmd+Shift+P to open picker
+- **Pick Colors**: Click anywhere on screen to sample
+- **Copy Formats**: HEX, RGB, HSL, SwiftUI, CSS, and more
+- **History**: Access recently picked colors
+- **Panel/Popover**: Choose your preferred display mode
 
-### Clipboard & Widgets
+### Clipboard Manager
-- **Clipboard Panel**: Access recent clipboard items
+- **Always Active**: Clipboard history automatically tracked
-- **Weather Widget**: Current weather in notch (location access required)
+- **Panel Access**: Keyboard shortcut or tab navigation
-- **App Switcher**: Swipe to switch apps
+- **Quick Copy**: Click any item to copy to clipboard
+- **Visual Previews**: See thumbnails of copied content
+
+### Screen Assistant
+- **AI Analysis**: Intelligent screen content understanding
+- **Context Aware**: Smart suggestions based on what you're viewing
+- **Keyboard Shortcut**: Quick activation
+- **Privacy First**: Local processing, no data sent externally
 
 ### Customization
-- **Preferences Pane**: Long-press notch to open
+- **Settings Window**: Click menubar icon → Settings
+- **Profile Switch**: Change between Developer/Designer/Light/Student modes
+- **Minimalistic Toggle**: Enable/disable compact layout
+- **Feature Toggles**: Enable/disable individual features
+- **Keyboard Shortcuts**: Customize all hotkeys
 - **Themes**: Light, dark, system adaptive
-- **Widget Settings**: Enable/disable, adjust sizes, display preferences
-- **Gestures**: Customize swipe, tap, long-press actions
 
 ---
 
 ## ⚙️ Configuration
 
 ### Settings Categories
-- **Stats**: Enable/disable CPU, Memory, GPU, Network, Disk monitoring
+
-- **Music & Media**: Visualizer type, color adaptation, media sources
+#### General
-- **Timer**: Default duration, notification style, colors, auto-start
+- **Menubar Icon**: Show/hide menubar icon
-- **Appearance & Behavior**: Theme, hover sensitivity, animation speed, corner radius, shadow effects
 - **Multi-Display Support**: Choose main monitor, show on all displays
-- **Keyboard Shortcuts**: Toggle DynamicIsland, open settings, quick stats, timer control
+- **Minimalistic Mode**: Enable compact 420px layout
+- **User Profiles**: Switch between Developer/Designer/Light/Student
+
+#### Appearance
+- **Corner Radius Scaling**: Adjust notch roundness
+- **Lighting Effects**: Album art glow and player tinting
+- **Shadow Effects**: Enable/disable drop shadows
+- **Mirror Feature**: Toggle camera preview
+- **Modern Animations**: Choose animation styles
+- **Themes**: Light, dark, system adaptive
+
+#### Behavior
+- **Hover Sensitivity**: Adjust activation distance
+- **Open on Hover**: Auto-expand on cursor proximity
+- **Haptic Feedback**: Enable/disable haptics
+- **Gestures**: Customize swipe, tap, long-press actions
+
+#### Features
+- **Stats Monitoring**: Enable/disable CPU, Memory, GPU, Network, Disk
+- **ColorPicker**: Toggle feature, set keyboard shortcut, panel/popover mode
+- **Clipboard Manager**: Always enabled, configure display mode
+- **Screen Assistant**: Enable/disable, set keyboard shortcut
+- **Timer**: Default duration, notification style, colors
+- **Music & Media**: Visualizer type, color adaptation, media sources
+
+#### Keyboard Shortcuts
+- **Toggle Notch**: Open/close DynamicIsland
+- **Sneak Peek**: Quick preview toggle
+- **Clipboard**: Open clipboard panel
+- **ColorPicker**: Activate color picker (default: Cmd+Shift+P)
+- **Screen Assistant**: Open AI assistant
+- **Stats Panel**: Toggle monitoring window
+- **Demo Timer**: Start 5-minute timer
+- **All Customizable**: Remap any shortcut
+
+#### Privacy & Permissions
+- **Accessibility**: Required for ColorPicker, Screen Assistant
+- **Camera**: For mirror feature
+- **Calendar**: For event display
+- **Music**: For playback controls
+
+### Reset to Defaults
+Use the included script to reset all settings:
+```bash
+./reset_app_defaults.sh
+```
+This will:
+- Clear all UserDefaults
+- Remove application support files
+- Remove caches and preferences
+- Reset to fresh install state (shows onboarding)
 
 ---
 
 ## 🚧 Roadmap
 
+### ✅ Recently Added
+- **Minimalistic Mode**: Compact 420px layout for light use
+- **Smart Onboarding**: Profile-based setup (Developer/Designer/Light/Student)
+- **ColorPicker**: Professional screen color picking tool
+- **Clipboard Manager**: Always-on clipboard history
+- **Screen Assistant**: AI-powered screen analysis
+- **Panel System**: Floating windows and integrated popovers
+- **Lighting Effects**: Album art glow and player tinting
+- **Stats Panel**: Floating system monitoring window
+- **Enhanced Keyboard Shortcuts**: Full customization support
+
 ### 🔄 Upcoming Features
 - **Enhanced Calendar Integration**: Weekly/monthly views, event details
 - **Weather Widget**: Location-based forecasts, beautiful animations
@@ -185,28 +349,91 @@ open DynamicIsland.xcodeproj
 - **3D Animations**: Enhanced visual effects
 - **Plugin Architecture**: Third-party extensions
 - **Cross-Platform**: iPad/iPhone companion apps
+- **Localization**: Multi-language support
 
 ---
 
 ## 🔧 Troubleshooting
 
 ### Common Issues & Solutions
-- **Permissions**: Enable Accessibility, Screen Recording, Full Disk Access
-- **Stats Not Updating**: Check feature toggles, restart monitoring, verify permissions
-- **Music Controls Not Working**: Ensure media app is playing, check permissions, restart app
-- **Performance Issues**: Reduce update frequency, disable unused features, restart app
 
-### Advanced
+#### Permissions
-- **Reset to Defaults**:
+- **Accessibility**: Required for ColorPicker and Screen Assistant
-   ```bash
+  - Go to System Settings → Privacy & Security → Accessibility
-   defaults delete com.ebullioscopic.DynamicIsland
+  - Enable DynamicIsland
-   ```
+  - **Important**: Quit and restart the app after granting permission
-- **Clean Reinstall**:
+- **Camera**: For mirror feature
-   1. Quit DynamicIsland
+- **Calendar**: For event display
-   2. Delete app from Applications
+- **Screen Recording**: For advanced features (optional)
-   3. Remove settings: `~/Library/Preferences/com.ebullioscopic.DynamicIsland.plist`
+
-   4. Reinstall from latest build
+#### Stats Not Updating
-- **Debug Mode**: Hold `⌥` while opening Settings → Advanced → Debug Mode → Enable Verbose Logging
+- Check feature toggles in Settings → Stats
+- Verify Stats feature is enabled
+- Restart monitoring from Settings
+- Check Activity Monitor for CPU/memory usage
+
+#### Music Controls Not Working
+- Ensure media app (Music, Spotify, etc.) is playing
+- Check Music permission in System Settings
+- Restart DynamicIsland
+- Try switching between media apps
+
+#### ColorPicker Not Working
+- Grant Accessibility permission (see above)
+- **Must quit and restart** app after granting permission
+- Check keyboard shortcut isn't conflicting
+- Verify ColorPicker feature is enabled in Settings
+
+#### Window Positioning Issues
+- If notch appears shifted after toggling Minimalistic Mode:
+  - This was fixed in recent updates
+  - Update to latest version
+  - Window now repositions immediately
+
+#### Performance Issues
+- Reduce stats update frequency in Settings
+- Disable unused features (Stats, Visualizer, etc.)
+- Check "Minimalistic Mode" for lighter resource usage
+- Close other resource-intensive apps
+- Restart DynamicIsland
+
+### Advanced Troubleshooting
+
+#### Reset to Factory Defaults
+Use the included reset script:
+```bash
+cd /path/to/DynamicIsland
+./reset_app_defaults.sh
+```
+
+Or manually:
+```bash
+# Clear UserDefaults
+defaults delete com.karthikinformationtechnology.DynamicIsland
+
+# Remove app data
+rm -rf ~/Library/Application\ Support/DynamicIsland
+rm -rf ~/Library/Caches/com.karthikinformationtechnology.DynamicIsland
+rm -f ~/Library/Preferences/com.karthikinformationtechnology.DynamicIsland.plist
+rm -rf ~/Library/Saved\ Application\ State/com.karthikinformationtechnology.DynamicIsland.savedState
+```
+
+#### Clean Reinstall
+1. Quit DynamicIsland
+2. Delete app from Applications
+3. Run reset script (above)
+4. Rebuild from Xcode
+
+#### Debug Mode
+- Hold `⌥` while opening Settings
+- Navigate to Advanced → Debug Mode
+- Enable Verbose Logging
+- Check Console.app for detailed logs
+
+### Getting Help
+- **GitHub Issues**: [Report bugs or request features](https://github.com/Ebullioscopic/DynamicIsland/issues)
+- **Discussions**: [Ask questions, share ideas](https://github.com/Ebullioscopic/DynamicIsland/discussions)
+- **Documentation**: Check `ONBOARDING_ENHANCEMENT.md`, `SYSTEM_TIMER_DETECTION.md` for detailed guides
 
 ---
 

reset_app_defaults.sh

@@ -0,0 +1,80 @@
+#!/bin/bash
+
+# Reset DynamicIsland App - Clear all defaults and app state
+# This script simulates a fresh first launch of the app
+
+set -e  # Exit on error
+
+APP_NAME="DynamicIsland"
+BUNDLE_ID="com.karthikinformationtechnology.DynamicIsland"
+
+echo "🧹 Resetting $APP_NAME to factory defaults..."
+echo ""
+
+# Step 1: Kill the app if it's running
+echo "1️⃣  Checking if $APP_NAME is running..."
+if pgrep -x "$APP_NAME" > /dev/null; then
+    echo "   ⚠️  $APP_NAME is running. Terminating..."
+    killall "$APP_NAME" 2>/dev/null || true
+    sleep 1
+    echo "   ✅ App terminated"
+else
+    echo "   ℹ️  $APP_NAME is not running"
+fi
+
+# Step 2: Clear UserDefaults
+echo ""
+echo "2️⃣  Clearing UserDefaults for $BUNDLE_ID..."
+defaults delete "$BUNDLE_ID" 2>/dev/null && echo "   ✅ UserDefaults cleared" || echo "   ℹ️  No UserDefaults found (already clean)"
+
+# Step 3: Remove Application Support files
+echo ""
+echo "3️⃣  Removing Application Support files..."
+APP_SUPPORT_DIR="$HOME/Library/Application Support/$APP_NAME"
+if [ -d "$APP_SUPPORT_DIR" ]; then
+    rm -rf "$APP_SUPPORT_DIR"
+    echo "   ✅ Removed: $APP_SUPPORT_DIR"
+else
+    echo "   ℹ️  No Application Support directory found"
+fi
+
+# Step 4: Remove Caches
+echo ""
+echo "4️⃣  Removing cached data..."
+CACHE_DIR="$HOME/Library/Caches/$BUNDLE_ID"
+if [ -d "$CACHE_DIR" ]; then
+    rm -rf "$CACHE_DIR"
+    echo "   ✅ Removed: $CACHE_DIR"
+else
+    echo "   ℹ️  No cache directory found"
+fi
+
+# Step 5: Remove Preferences plist (backup of defaults)
+echo ""
+echo "5️⃣  Removing preference files..."
+PREF_FILE="$HOME/Library/Preferences/$BUNDLE_ID.plist"
+if [ -f "$PREF_FILE" ]; then
+    rm -f "$PREF_FILE"
+    echo "   ✅ Removed: $PREF_FILE"
+else
+    echo "   ℹ️  No preference file found"
+fi
+
+# Step 6: Remove Saved Application State
+echo ""
+echo "6️⃣  Removing saved application state..."
+SAVED_STATE_DIR="$HOME/Library/Saved Application State/$BUNDLE_ID.savedState"
+if [ -d "$SAVED_STATE_DIR" ]; then
+    rm -rf "$SAVED_STATE_DIR"
+    echo "   ✅ Removed: $SAVED_STATE_DIR"
+else
+    echo "   ℹ️  No saved state found"
+fi
+
+# Done
+echo ""
+echo "✨ Reset complete! $APP_NAME will show onboarding on next launch."
+echo ""
+echo "To launch the app now, run:"
+echo "  open -a $APP_NAME"
+echo ""