CluckOut Support

What's New in Version 1.4.3

⌚ Apple Watch Support

Full Apple Watch app for time tracking on the go! Clock in and clock out directly from your wrist with real-time synchronization between your iPhone and Apple Watch. Perfect for when you need to track time without reaching for your phone.

🔄 Real-Time Synchronization

Seamless bidirectional communication between iPhone and Apple Watch ensures your time tracking status is always in sync. Clock in from your watch and see it instantly on your iPhone, or vice versa. Automatic status updates keep both devices current.

📊 Live Duration Tracking

Watch app displays your current session duration in real-time with formatted time display (hours, minutes, seconds). See your connection status and current check-in state at a glance.

🎨 UI Improvements

Enhanced watch app button styling with clean design. Improved error handling with user-friendly messages and automatic session management.

What's New in Version 1.4.2

📅 Year Time Frame View

New "Year" option added to Time Frame selector in Summary view! View your time records aggregated by year, with all entries from January 1st to December 31st of the selected year. Includes consistent navigation, filtering support, and quick navigation button to jump to current year.

📊 Multiple Export Formats

Export your time records in multiple formats for maximum compatibility! Choose from CSV (standard), CSV (Excel-compatible with UTF-8 BOM), or JSON format. All formats maintain data integrity and support all existing features including categories, time periods, and filtering.

📥 Multiple Import Formats

Enhanced import functionality with automatic format detection! The app now supports CSV, Excel (.xlsx, .xls), and JSON file formats. Automatic format detection based on file extension ensures a seamless import experience regardless of format.

🔧 Bug Fixes & Improvements

Fixed Excel import BOM handling for proper round-trip export/import, and updated format display names for clarity to prevent user confusion about file types.

What's New in Version 1.4.1

🗑️ Enhanced Clear Records Feature

Major upgrade to the clear records functionality with comprehensive filtering options! Delete records by time period (last 7/30/90 days, this month/year, custom periods, or all records) and by category. Preview what will be deleted before confirming, with real-time statistics showing entry count, total duration, and total earnings.

🔧 Bug Fixes & Improvements

Fixed default category creation to properly mark categories as default, and resolved CSV import issues with improved category handling and verification.

What's New in Version 1.4.0

🎯 Enhanced Time Tracking Experience

Major upgrade to the time tracking interface with meaningful animations and visual feedback! Enjoy logo pulse animations during active tracking, breathing button effects, and real-time duration updates with estimated pay display.

📊 Advanced Data Management

Comprehensive import/export system with progress indicators and enhanced error handling! Import CSV files with legacy format support, export with flexible time period filtering, and enjoy clean progress overlays for all data operations.

💰 Category-Specific Rate Management

Set individual hourly rates for different work categories! Premium feature that allows you to track different rates for different types of work, with enhanced batch rate updates and category filtering options.

🔔 Smart Reminder System

Complete reminder management with full CRUD operations! Create repeatable reminders, edit existing ones, and enjoy automatic notification cleanup with enhanced permission management.

🎨 UI/UX Improvements

Interactive date navigation with DatePickers, standardized picker components, and enhanced navigation bar appearance. Fixed dark mode issues and improved overall user experience across all views.

What's New in Version 1.3.2

What's New in Version 1.3.2

🔔 Complete Reminder System Overhaul

Major upgrade to the reminder functionality with flexible scheduling and comprehensive management! Create repeatable reminders for specific days of the week, edit existing reminders, and enjoy intelligent reminder behavior that automatically manages notifications.

📅 Repeatable Reminder Scheduling

Set reminders to repeat on specific days of the week! Choose from weekdays, weekends, or custom combinations. The app intelligently displays your schedule (e.g., "Weekdays", "Mon, Wed, Fri") and provides convenient "Select All" and "Clear All" buttons.

✏️ Editable Reminder Management

Full editing capabilities for all your reminders! Modify reminder type, time, repeatable days, and enabled state. Delete reminders with confirmation alerts, and enjoy automatic notification rescheduling when changes are made.

What's New in Version 1.3.1

What's New in Version 1.3.1

📊 Enhanced Time Period Export Support

Export your time records with flexible time period filtering! Choose from predefined periods (last 7/30/90 days, this month/year) or set custom date ranges. Perfect for generating reports for specific time periods.

📋 Import/Export Summary System

Get comprehensive feedback for all your data operations! View detailed statistics including record count, total duration, and earnings for both import and export operations with real-time updates.

🔧 Enhanced CSV Import Functionality

Improved import system with better error handling and overnight shift support! The app now properly handles records that span midnight and provides comprehensive debug logging for troubleshooting.

What's New in Version 1.2.2

What's New in Version 1.2.2

🔔 Enhanced Reminder Notification System

Complete overhaul of notification permission handling with improved user experience! The app now provides better guidance for notification setup and ensures reminders work reliably.

🎯 Improved Reminder Toggle Behavior

Better reminder management with automatic permission checking. The toggle is now disabled when notification permission is not granted, preventing confusion and ensuring reminders only work when properly configured.

What's New in Version 1.2.0

What's New in Version 1.2.0

🎯 New Batch Rate Update Feature

Update hourly rates across multiple time entries at once! Choose from predefined periods (last 7/30/90 days, this month/year) or set custom date ranges.

📊 Enhanced CSV Import Support

Import your time records with automatic format detection! The app now supports both legacy time formats (HH:mm) and current formats (HH:mm:ss), making it easy to import data from older systems or different sources.

Time Tracking Basics

How do I track my time?

From iPhone:
1. Open CluckOut
2. Tap "Clock In" when you start working
3. Tap "Clock Out" when you finish

From Apple Watch (New in 1.4.3):
1. Open the CluckOut app on your Apple Watch
2. Tap "Clock In" or "Clock Out" directly from your wrist
3. Your status syncs automatically with your iPhone

Enhanced in 1.4.0: Time tracking now includes meaningful animations with logo pulse effects, breathing button animations, and real-time duration updates with estimated pay display. Enjoy haptic feedback on supported devices for a more engaging experience.

New in 1.4.3: Full Apple Watch support allows you to track time from your wrist with real-time synchronization between devices. Perfect for quick clock in/out without reaching for your phone.

How do I edit a time entry?

1. Go to the Summary tab
2. Tap on the entry you want to edit
3. Modify the clock-in/clock-out times with second-level precision
4. Tap Save

Improved: Edit interface now supports more precise time adjustments and provides better validation.

How do I add a manual time entry?

1. Go to the Summary tab
2. Tap the "+" button
3. Enter clock-in and clock-out times with second-level precision
4. Set the hourly rate for this entry
5. Tap Save

Enhanced: Manual entry now supports more precise time input and better rate management.

Hourly Rates & Earnings

How do hourly rates work?

• Each time entry can have its own hourly rate
• Set your default rate in Settings
• Modify individual entry rates by editing the entry
• Rates are preserved historically for completed entries

Enhanced: Better rate validation and consistent formatting across all views.

How are earnings calculated?

• Earnings are calculated based on each entry's specific rate
• Active entries use your current default rate
• Completed entries maintain their historical rates
• Real-time updates for active entries

Improved: More accurate calculations with better precision and real-time updates.

How do I update rates for multiple entries?

Enhanced Batch Rate Update Feature:
1. Go to Settings > Hourly Rate
2. Tap "Batch Rate Update"
3. Enter your new rate
4. Select a time period (last 7/30/90 days, this month/year, or custom)
5. Choose category scope (All Categories, Selected Categories, or Specific Category)
6. Preview current rates before updating
7. Tap "Update Rates" to apply changes

This feature allows you to quickly update rates for all entries within a specific time period and category scope, perfect for when your pay rate changes!

Enhanced in 1.4.0: Category-specific filtering, preview functionality, comprehensive error handling, and immediate UI updates after changes.

How do I set my default hourly rate?

1. Go to Settings
2. Select "Hourly Rate"
3. Enter your rate (supports up to 2 decimal places)
4. The rate will be applied to new entries automatically

Enhanced: Better input validation and formatting for consistent rate entry.

How do I set category-specific rates?

New in 1.4.0 - Premium Feature:
1. Go to Settings > Manage Categories
2. Select a category to edit
3. Set a specific hourly rate for that category
4. Categories without specific rates will use your global rate

This feature allows you to track different rates for different types of work. For example, you might charge $50/hour for consulting but $25/hour for administrative tasks.

Features: Category-specific rate management, enhanced batch rate updates with category filtering, and automatic fallback to global rates.

Data Management

How do I export my time records?

1. Go to Settings
2. Select "Records Management"
3. Tap "Export Records"
4. Choose export format (CSV, CSV Excel-compatible, or JSON)
5. Choose time period filtering (last 7/30/90 days, this month/year, custom periods)
6. Select categories to include in export

New in 1.4.2: Export now supports multiple formats! Choose from CSV (standard), CSV (Excel-compatible with UTF-8 BOM), or JSON format. All formats maintain data integrity and support all existing features.

Enhanced in 1.4.0: Export includes flexible time period filtering, progress indicators during export, and category-specific data. Enjoy clean progress overlays and comprehensive error handling.

How do I import records?

1. Go to Settings > Records Management
2. Tap "Import History"
3. Select your file (CSV, Excel, or JSON)
4. Watch progress indicators during import

New in 1.4.2: Import now supports multiple file formats! The app automatically detects the format based on file extension (.csv, .xlsx, .xls, .json). Supports CSV files, Excel-compatible files with UTF-8 BOM handling, and JSON files with DataFrame format.

Enhanced in 1.4.0: Import includes progress indicators, enhanced error handling, and overnight shift support. Enjoy clean progress overlays and comprehensive validation.

Legacy Format Support: The app automatically detects and supports multiple time formats:

Note: Import files should include clock-in time, clock-out time, and optionally hourly rate. The app will automatically handle format detection, duplicate prevention, and overnight shift logic.

How do I delete my records?

Enhanced in 1.4.1 - Selective Record Deletion:
1. Go to Settings > Records Management
2. Tap "Delete All Records"
3. Choose a time period (last 7/30/90 days, this month/year, custom period, or all records)
4. Select category filtering (all categories or specific categories)
5. Preview what will be deleted (entry count, total duration, total earnings)
6. Confirm the action

This feature allows you to selectively delete records by time period and category, perfect for cleaning up specific data without losing everything. You can preview exactly what will be deleted before confirming.

Enhanced in 1.4.1: Period and category filtering, real-time preview with statistics, and improved error handling with detailed alerts for delete operations.

How do I navigate through my time records?

1. Go to the Summary tab
2. Use the date navigator to browse different time periods
3. Tap on time frame options to filter records (Day, Week, Month, or Year)

New in 1.4.2: Added "Year" time frame option! View all entries from January 1st to December 31st of the selected year with quick navigation to current year.

Improved in 1.2.0: Enhanced date navigation with better browsing experience and improved time frame selection.

Notifications & Reminders

How do I set up reminders?

1. Go to Settings
2. Select "Reminders"
3. If notification permission is not granted, tap "Request Notification Permission"
4. Allow notifications when prompted
5. Enable reminders and set your preferred times

Enhanced in 1.3.2: Complete reminder system overhaul with flexible scheduling! You can now create repeatable reminders for specific days of the week, edit existing reminders, and enjoy intelligent reminder behavior.

What if notification permission is denied?

If notification permission is denied, the reminder toggle will be disabled and you'll see a warning message. To fix this:

1. Tap "Open Settings" in the Reminders section
2. Navigate to CluckOut in iOS Settings
3. Enable "Allow Notifications"
4. Return to the app and try enabling reminders again

New in 1.2.2: The app now provides clear guidance and direct access to iOS Settings when permission is denied.

How do I manage my reminders?

1. Go to Settings > Reminders
2. View your current reminder settings
3. Add new reminders or modify existing ones
4. Enable/disable reminders as needed

Enhanced in 1.3.2: Complete reminder management overhaul! You can now edit all aspects of existing reminders including type, time, repeatable days, and enabled state. Delete reminders with confirmation alerts, and enjoy automatic notification rescheduling when changes are made.

How do repeatable reminders work?

New in 1.3.2: Create reminders that repeat on specific days of the week!

• Choose from weekdays, weekends, or custom day combinations
• The app intelligently displays your schedule (e.g., "Weekdays", "Mon, Wed, Fri")
• Use "Select All" and "Clear All" buttons for convenient day selection
• Edit repeatable days at any time with automatic notification rescheduling

How do I edit my reminders?

New in 1.3.2: Full editing capabilities for all your reminders!

• Tap on any existing reminder to open the edit interface
• Modify reminder type, time, repeatable days, and enabled state
• Delete reminders with confirmation alerts to prevent accidental removal
• All changes automatically reschedule notifications to maintain consistency
• Individual enable/disable toggles for each reminder

Why is the reminder toggle disabled?

The reminder toggle is disabled when notification permission is not granted. This ensures that reminders only work when properly configured. To enable it:

• If you haven't granted permission yet: Tap "Request Notification Permission"
• If permission was denied: Tap "Open Settings" to enable notifications in iOS Settings

New in 1.2.2: Automatic permission checking prevents reminders from being enabled without proper notification setup.

Navigation & Interface

What's new in the interface?

Version 1.4.3 Improvements:
• Full Apple Watch app for time tracking on your wrist
• Real-time synchronization between iPhone and Apple Watch
• Enhanced watch app button styling with clean design
• Connection status indicator on watch app

Version 1.4.0 Improvements:
• Interactive date navigation with DatePickers in Day, Week, and Month views
• Meaningful animations with logo pulse effects and breathing buttons
• Standardized picker components with dropdown interface
• Fixed navigation title color issues in dark mode
• Enhanced haptic feedback on supported devices
• Real-time duration updates with estimated pay display

How do I use the improved navigation?

• Interactive DatePickers in Day, Week, and Month views for direct date selection
• Dual navigation options: arrow buttons for quick navigation + DatePicker for direct selection
• Standardized dropdown pickers across all settings views
• Enhanced navigation bar appearance with fixed dark mode issues
• Smart disable logic prevents navigation beyond current date

Enhanced in 1.4.0: Interactive date navigation with DatePickers, standardized picker components, and improved navigation hierarchy management.

What accessibility improvements are available?

• Dynamic type support with controlled maximum sizes
• Better contrast and readability
• Improved screen reader compatibility
• Enhanced focus management

New: Font sizes are now limited using UIFontMetrics to maintain layout consistency while supporting accessibility features.

How do I view my statistics?

1. Go to the Summary tab
2. View your time tracking statistics
3. See estimated earnings based on your rates

Enhanced: Statistics now calculate earnings using individual entry rates with improved accuracy and real-time updates.

Apple Watch

How do I use the Apple Watch app?

New in 1.4.3: CluckOut now includes a full Apple Watch app for time tracking on the go!

1. Make sure your Apple Watch is paired with your iPhone
2. Install CluckOut on your iPhone (the watch app installs automatically)
3. Open the CluckOut app on your Apple Watch
4. Tap "Clock In" or "Clock Out" directly from your wrist
5. Your status syncs automatically with your iPhone in real-time

Features: Real-time duration display, connection status indicator, automatic synchronization, and error handling with user-friendly messages.

What Apple Watch models are supported?

CluckOut supports Apple Watch Series 3 and later running watchOS 8.0 or later. The watch app requires a paired iPhone with the CluckOut app installed.

Why isn't my watch app connecting to my iPhone?

If you see a connection error on your watch app:

• Make sure your Apple Watch is paired with your iPhone
• Ensure both devices are nearby and Bluetooth is enabled
• Try restarting both the watch app and iPhone app
• Check that the CluckOut app is installed on your iPhone

The watch app requires an active Watch Connectivity session to communicate with your iPhone. The connection status indicator shows whether the session is active.

Can I use the watch app without my iPhone nearby?

The watch app requires an active connection to your iPhone via Watch Connectivity to clock in and out. While you can view the app interface, clock in/out operations require the iPhone to be nearby and connected via Bluetooth.

Troubleshooting

What if my time entries aren't saving correctly?

• Ensure you have sufficient storage space on your device
• Try restarting the app
• Check that you're connected to the internet for cloud sync (if enabled)
• If using Apple Watch, ensure your watch is connected to your iPhone

Enhanced: Better error handling and validation now prevent most data loss issues.

Why aren't my earnings calculating correctly?

• Verify your hourly rate is set correctly in Settings
• Check that individual entries have the correct rates
• Ensure time entries have both clock-in and clock-out times

Improved: More accurate calculations with better precision and real-time updates.

How do I reset my data if something goes wrong?

1. Go to Settings > Records Management
2. Tap "Delete All Records"
3. Choose your deletion options (time period and category filtering)
4. Preview what will be deleted
5. Confirm the action

Enhanced in 1.4.1: You can now selectively delete records by time period and category, allowing you to clean up specific data without losing everything. Preview what will be deleted before confirming.

Note: This action cannot be undone, so make sure to export your data first if needed.

Need Additional Help?

For support inquiries, please email: hsudev138@gmail.com