jsonify
diff --git a/‎.release-please-manifest.json‎
Lines changed: 3 additions & 0 deletions b/‎.release-please-manifest.json‎
Lines changed: 3 additions & 0 deletions
diff --git a/‎CHANGELOG.md‎
Lines changed: 9 additions & 0 deletions b/‎CHANGELOG.md‎
Lines changed: 9 additions & 0 deletions
diff --git a/‎README.md‎
Lines changed: 245 additions & 36 deletions b/‎README.md‎
Lines changed: 245 additions & 36 deletions
@@ -0,0 +1,3 @@
+{
+  ".": "1.5.5"
+}
@@ -0,0 +1,9 @@
+# Changelog
+
+All notable changes to ClickIt will be documented in this file.
+
+This changelog is automatically generated by [Release Please](https://github.com/googleapis/release-please) based on [Conventional Commits](https://www.conventionalcommits.org/).
+
+## [1.5.5](https://github.com/jsonify/ClickIt/releases/tag/v1.5.5) (Current Version)
+
+Initial changelog. Previous release history can be found in GitHub releases.
@@ -4,36 +4,170 @@
 [![Release](https://github.com/jsonify/ClickIt/actions/workflows/release.yml/badge.svg)](https://github.com/jsonify/ClickIt/actions/workflows/release.yml)
 [![Latest Release](https://img.shields.io/github/v/release/jsonify/ClickIt)](https://github.com/jsonify/ClickIt/releases/latest)
 
-A lightweight, native macOS Auto-Clicker application with precision timing and advanced targeting capabilities. Designed for gamers, automation enthusiasts, and productivity users who need reliable, accurate clicking automation.
+**Professional macOS Auto-Clicker with Enterprise-Grade Precision**
+
+A native macOS automation tool built with SwiftUI that delivers sub-10ms timing accuracy and advanced window targeting. Perfect for gamers, QA testers, automation professionals, and power users who demand reliable, feature-rich clicking automation.
+
+## 🌟 Key Highlights
+
+**Unlike other auto-clickers, ClickIt offers:**
+
+1. **True Native Performance** - Built specifically for macOS with SwiftUI, not a cross-platform port
+2. **Advanced Window Targeting** - Click on specific apps even when they're minimized or in background
+3. **Sub-10ms Precision** - Professional-grade timing accuracy that competitors can't match
+4. **Universal Binary** - Fully optimized for both Intel and Apple Silicon processors
+5. **Enterprise Features** - Timer automation, preset management, and performance analytics
+6. **Zero Telemetry** - Your automation stays completely private and offline
+
+## Why Choose ClickIt?
+
+- ⚡ **Lightning Fast** - Sub-10ms click timing accuracy with precision interval control
+- 🎯 **Smart Targeting** - Advanced window detection that works even when apps are minimized
+- 🌐 **Universal Binary** - Optimized for both Intel x64 and Apple Silicon processors
+- 🎮 **Always Active** - Background operation without requiring app focus or interruption
+- ⌨️ **Global Control** - System-wide hotkey support (ESC key) for instant start/stop
+- 💾 **Preset System** - Save and instantly load custom clicking configurations
+- 👁️ **Visual Feedback** - Clear overlay indicators show exactly where clicks will occur
+- 🔒 **Permission Aware** - Streamlined permission setup with real-time monitoring
+- 📊 **Performance Stats** - Built-in analytics and monitoring dashboard
+
+## Core Features
+
+### 🎯 Advanced Click Automation
+- **Sub-10ms Precision** - Industry-leading timing accuracy for demanding automation tasks
+- **Window-Specific Targeting** - Click on specific applications, even when minimized or in background
+- **Multiple Click Modes** - Single clicks, double clicks, and hold/release patterns
+- **Coordinate Lock** - Pin clicks to exact screen coordinates or dynamic window positions
+- **Human-like Variation** - Optional randomization to mimic natural clicking patterns
+
+### ⚙️ Intelligent Configuration
+- **Preset Management** - Save unlimited custom configurations and switch instantly
+- **Timer Automation** - Schedule automatic start/stop times for unattended operation
+- **Interval Control** - Millisecond-level precision with CPS (Clicks Per Second) display
+- **Hotkey System** - Global ESC key control that works from any application
+- **Auto-Save States** - Automatically preserves your settings between sessions
+
+### 📊 Professional Tools
+- **Real-Time Performance Dashboard** - Monitor click rate, accuracy, and system performance
+- **Statistics Tracking** - View elapsed time, total clicks, and success rates
+- **Permission Monitoring** - Live status display for Accessibility and Screen Recording permissions
+- **Visual Feedback System** - Customizable overlay indicators show target locations
+- **Smart Status Bar** - Always-visible controls with compact, unobtrusive design
+
+### 🔒 Security & Reliability
+- **Permission-First Design** - Streamlined permission request flow with detailed instructions
+- **Automatic Permission Detection** - Real-time monitoring of required system permissions
+- **Safe Operation Mode** - Prevents accidental system-wide clicks during setup
+- **Crash Recovery** - Robust error handling ensures stable operation
+- **Privacy Focused** - No data collection, no analytics, completely offline operation
+
+## Who Uses ClickIt?
+
+### 🎮 Gamers
+- **Idle/Clicker Games** - Automate repetitive clicking in incremental games
+- **MMO Grinding** - Streamline repetitive tasks in online games
+- **Farming Simulators** - Automate resource collection and harvesting
+- **Achievement Hunting** - Complete click-intensive achievements efficiently
+
+### 🧪 QA & Testing Professionals
+- **UI/UX Testing** - Simulate user interactions for interface testing
+- **Load Testing** - Generate consistent user input patterns
+- **Regression Testing** - Automate repetitive test scenarios
+- **Browser Testing** - Click through web application workflows
+
+### 💼 Business & Productivity
+- **Data Entry** - Automate repetitive form filling and data input
+- **Batch Processing** - Handle large volumes of similar tasks
+- **Presentation Auto-Advance** - Automatic slideshow progression
+- **Monitoring Systems** - Keep applications active and responsive
+
+### ♿ Accessibility & Ergonomics
+- **Mobility Assistance** - Reduce physical strain for users with limited mobility
+- **Repetitive Strain Prevention** - Minimize manual clicking to prevent RSI
+- **Adaptive Computing** - Enable custom interaction patterns for accessibility needs
+- **Fatigue Reduction** - Automate long-duration clicking tasks
+
+## System Requirements
+
+### Minimum Requirements
+- **Operating System**: macOS 15.0 (Sequoia) or later
+- **Processor**: Intel x64 or Apple Silicon (M1/M2/M3/M4)
+- **Memory**: 50 MB RAM
+- **Storage**: 10 MB available disk space
+- **Permissions**:
+  - Accessibility (required for click simulation)
+  - Screen Recording (required for window targeting)
+
+### Recommended
+- **Operating System**: Latest macOS version for optimal performance
+- **Processor**: Apple Silicon for best energy efficiency
+- **Display**: Any resolution supported (tested on 1080p - 5K displays)
 
-## Features
-
-- **Native macOS Application**: Built with SwiftUI for optimal performance
-- **Universal Binary**: Supports both Intel x64 and Apple Silicon
-- **Advanced Window Targeting**: Works with any application, even when minimized
-- **Precision Timing**: Sub-10ms click timing accuracy with customizable intervals
-- **Visual Feedback**: Shows click points with overlay indicators
-- **Preset System**: Save and load custom clicking configurations
-- **Global Hotkeys**: System-wide controls for start/stop operations
-- **Variable Timing**: Human-like randomization patterns
-- **Background Operation**: Continues operation without requiring app focus
-
-## Use Cases
-
-- **Gaming**: Automated clicking for various games and applications
-- **Testing**: UI testing and automation workflows
-- **Productivity**: Repetitive task automation
-- **Accessibility**: Assistance for users with mobility limitations
-
-## Requirements
+## Installation
 
-- macOS 15.0 or later
-- Accessibility permissions (for mouse event simulation)
-- Screen Recording permissions (for window detection and targeting)
+### Quick Install (Coming Soon)
+Download the latest release from the [Releases page](https://github.com/jsonify/ClickIt/releases) and drag ClickIt.app to your Applications folder.
+
+### First Launch Setup
+1. **Launch ClickIt** - Double-click the app from Applications
+2. **Grant Permissions** - The app will guide you through:
+   - ✅ **Accessibility Permission** - Required for click automation
+   - ✅ **Screen Recording Permission** - Required for window targeting
+3. **Start Automating** - Configure your first preset and start clicking!
+
+The permission setup is streamlined with:
+- Clear visual indicators showing permission status
+- One-click access to System Settings
+- Real-time permission monitoring
+- Detailed help documentation for each permission type
+
+### Troubleshooting Installation
+If permissions aren't working after granting them:
+- Click "Refresh Status" in the permission gate screen
+- Restart the application
+- Check System Settings → Privacy & Security to verify permissions are enabled
+
+## 🚀 Quick Start Guide
+
+### Basic Workflow
+1. **Select Target** - Choose "Current Mouse Position" or select a specific window
+2. **Set Timing** - Configure click interval (supports milliseconds or CPS)
+3. **Start/Stop** - Press ESC key or use the in-app controls
+4. **Monitor** - View real-time statistics and performance metrics
+
+### Pro Tips
+- **Save Presets** - Create configurations for different games or applications
+- **Use Window Targeting** - Target specific apps to avoid accidental clicks
+- **Enable Visual Feedback** - See exactly where clicks will occur
+- **Timer Automation** - Schedule unattended clicking sessions
+- **Performance Dashboard** - Monitor click accuracy and system impact
+
+### Common Workflows
+
+**Gaming Setup:**
+```
+1. Launch your game
+2. Select game window as target
+3. Set desired CPS (clicks per second)
+4. Position mouse on target location
+5. Press ESC to start/stop
+```
 
-## Installation
+**Testing Automation:**
+```
+1. Create preset for test scenario
+2. Configure click sequence with precise timing
+3. Enable visual feedback for verification
+4. Use timer automation for repeated tests
+```
 
-[Installation instructions will be added once the app is ready for distribution]
+**Productivity Tasks:**
+```
+1. Target specific application window
+2. Set conservative click interval
+3. Use preset for quick configuration switching
+4. Monitor performance dashboard
+```
 
 ## Development
 
@@ -178,29 +312,104 @@ fastlane auto_beta
 ```
 
 #### **Production Release**
+
+**NEW: Automated with Release Please**
 ```bash
-# 1. Promote staging to main
-git checkout main && git merge staging
+# 1. Use conventional commits
+git commit -m "feat: add new feature"  # Minor bump
+git commit -m "fix: correct bug"       # Patch bump
+git commit -m "feat!: breaking change" # Major bump
+
+# 2. Merge to main (via PR)
+# Release Please automatically:
+# - Creates a release PR with version bump
+# - Updates CHANGELOG.md
+# - Creates GitHub release when PR is merged
+# - Triggers build workflow
+
+# See docs/RELEASE_PROCESS.md for details
+```
 
-# 2. Automated release with version bumping
+**Legacy: Manual Release (Deprecated)**
+```bash
+# Old process - use Release Please instead
 fastlane bump_and_release bump:minor  # 1.0.0 → 1.1.0
 ```
 
 ### 📚 **Additional Documentation**
 - **[CLAUDE.md](CLAUDE.md)** - Development guidance and project overview
 - **[BUILD_AND_DEPLOY.md](BUILD_AND_DEPLOY.md)** - Manual build and deployment instructions
 - **[CERTIFICATE_SETUP.md](CERTIFICATE_SETUP.md)** - Code signing certificate setup
+- **[docs/RELEASE_PROCESS.md](docs/RELEASE_PROCESS.md)** - Automated release process with Release Please
+
+## 🤝 Contributing
+
+We welcome contributions from the community! Whether you're fixing bugs, adding features, improving documentation, or helping with translations, your help is appreciated.
+
+### How to Contribute
+
+1. **Check Existing Issues** - Browse the [Issues](https://github.com/jsonify/ClickIt/issues) tab for tasks that need help
+2. **Fork & Branch** - Create a feature branch from `main` following our [Git Workflow Guide](docs/git-workflow-guide.md)
+3. **Make Changes** - Write clean, well-documented code following our style guidelines
+4. **Test Thoroughly** - Ensure your changes work on both Intel and Apple Silicon
+5. **Submit PR** - Use [Conventional Commits](https://www.conventionalcommits.org/) format for commit messages
+
+### Areas We Need Help With
+- 🐛 **Bug Reports** - Found an issue? Report it with detailed steps to reproduce
+- ✨ **Feature Requests** - Have ideas for improvements? Open a feature request
+- 📝 **Documentation** - Help improve guides, tutorials, and code comments
+- 🌍 **Localization** - Translate ClickIt to other languages
+- 🧪 **Testing** - Test on different macOS versions and hardware configurations
+
+### Development Setup
+See the [Development](#development) section below for setup instructions and our comprehensive [Git Workflow Guide](docs/git-workflow-guide.md).
+
+## 🗺️ Roadmap
+
+ClickIt is under active development. Here's what's coming:
+
+### In Progress
+- ⏳ **UI Optimization** - Tabbed interface with improved space utilization (v2.0)
+- ⏳ **Timer Automation** - Schedule automatic start/stop times
+- ⏳ **Performance Dashboard** - Real-time analytics and monitoring
+
+### Planned Features
+- 🔄 **Click Recording** - Record and replay complex click sequences
+- 🎯 **Multi-Point Patterns** - Click multiple locations in sequence
+- 🎨 **Custom Themes** - Dark/light mode and custom color schemes
+- 🌍 **Localization** - Multi-language support
+- 📊 **Advanced Analytics** - Export statistics and performance reports
+- ⌨️ **Custom Hotkeys** - Configure your own keyboard shortcuts
+- 🔌 **AppleScript Support** - Integrate with system automation
+
+Want to see a feature added? [Open a feature request](https://github.com/jsonify/ClickIt/issues/new)!
+
+## 💬 Support & Community
 
-## Contributing
+### Getting Help
+- 📖 **Documentation** - Check the docs in the `/docs` folder
+- 🐛 **Bug Reports** - [Open an issue](https://github.com/jsonify/ClickIt/issues/new) with detailed information
+- 💡 **Feature Requests** - Share your ideas in the Issues tab
+- 🤔 **Questions** - Ask in GitHub Discussions or open an issue
 
-Contributions are welcome! Please read our contributing guidelines and check the Issues tab for open tasks.
+### Reporting Issues
+When reporting bugs, please include:
+- macOS version and processor type (Intel/Apple Silicon)
+- ClickIt version number
+- Steps to reproduce the issue
+- Expected vs. actual behavior
+- Relevant error messages or logs
 
-**Before contributing**: Read the [Git Workflow Guide](docs/git-workflow-guide.md) to understand our branch strategy and release process.
+## 📄 License
 
-## License
+MIT License - see [LICENSE](LICENSE) file for details.
 
-MIT License - see LICENSE file for details
+## ⚖️ Disclaimer
 
-## Disclaimer
+ClickIt is intended for **legitimate automation purposes only**. Users are responsible for ensuring their use complies with:
+- Terms of service of applications they interact with
+- Applicable local, state, and federal laws
+- Gaming platform policies and fair play guidelines
+- Workplace automation policies
 
-This software is intended for legitimate automation purposes. Users are responsible for ensuring their use complies with the terms of service of any applications they target and applicable laws and regulations.
+**Use responsibly and ethically.** The developers of ClickIt are not responsible for misuse of this software.