# UpDock Free Beta Testing

Test the current Mac App Store Free build. For every issue, record the UpDock version/build, macOS version, Mac model, display arrangement, expected result, actual result, and reproducible steps.

## Install, Identity, and Privacy

- [ ] Install, launch, quit, relaunch, and restart the Mac.
- [ ] Confirm Settings and Diagnostics show **UpDock**, the correct version/build, Free status, a 5 mini-dock limit, and a 7 item-per-dock limit.
- [ ] Confirm the app, menus, alerts, App Intents, Shortcuts metadata, and diagnostics contain no mention or purchase link for the separately distributed edition.
- [ ] Confirm **Upgrade to UpDock+** and **Restore Purchases** use StoreKit and remain understandable when offline or canceled.
- [ ] Confirm no unexpected network activity occurs except StoreKit, URL favicon retrieval, and user-initiated links.

## Mini-Dock Management

- [ ] Verify the two general starter docks and disabled Accessibility starter dock on a fresh install.
- [ ] Create, rename, duplicate, delete, enable, disable, select, and manually reorder mini-docks.
- [ ] Confirm the sixth mini-dock is rejected with an UpDock+ explanation.
- [ ] Confirm the eighth item in a mini-dock is rejected without losing existing items.
- [ ] Test left, right, and bottom edges, including multiple docks assigned to one edge.
- [ ] Choose the Apple Dock edge and confirm conflicting mini-docks are reassigned.
- [ ] Test icon size, always-visible labels, hover-bubble labels, trigger thickness, trigger delay, auto-hide delay, and enabled state.
- [ ] Save one dock's settings as defaults and confirm new mini-docks use them.
- [ ] Use one mini-dock as the default item template; apply My Defaults and Factory Defaults.
- [ ] Confirm Reset Defaults warns that all user-created mini-docks will be removed.
- [ ] Confirm double-click activation, Settings ABC sorting, and customized Shift Items remain unavailable in Free.

## Dock Items

- [ ] Add and open applications, files, folders, URLs, separators, multiple Finder selections, special folders, a Finder icon, and a BBEdit project folder.
- [ ] Confirm apps, Xcode projects/workspaces, AppleScript bundles, Automator workflows, and other packages are treated as files or applications rather than browsable folders.
- [ ] Rename, reorder, duplicate where offered, remove, and reveal items in Finder.
- [ ] Test Open With Default, Finder, BBEdit, Xcode, and a chosen application.
- [ ] Confirm URL names and favicons load, refresh, persist after relaunch, and fail gracefully offline.
- [ ] Choose, paste, restore, export, and re-import custom icons; verify the Custom Icons library retains selected originals.
- [ ] Confirm Show Package Contents is not offered in Free.

## Drag, Drop, and Folders

- [ ] Open **Hierarchy** and confirm the mini-dock, folders, nested folders, and all descendants appear in saved order.
- [ ] Expand/collapse all levels; select one item, Command-select multiple items, and select a folder together with descendants without duplicate operations.
- [ ] Drag one or multiple selected items before siblings, into folders, between nested levels, and onto the mini-dock root to move them out.
- [ ] Create an empty top-level or nested folder; create a folder with selected items and confirm those items move inside in their original order.
- [ ] Rename and delete individual or multiple hierarchy items; verify deleting a folder removes its displayed descendants only after the requested action.
- [ ] Drag files, apps, packages, and folders from Finder into the root, insertion slots, and nested folder targets.
- [ ] Drag an item from another visible mini-dock into the hierarchy and confirm it is copied while the source remains unchanged.
- [ ] Confirm a folder cannot be moved into itself or its descendants and full destinations reject the entire operation without data loss.
- [ ] Reorder items inside a mini-dock and verify there are no duplicates or linked pseudo-duplicates.
- [ ] Copy an item from another mini-dock and verify the source remains unchanged.
- [ ] Drag Finder items into a visible mini-dock; verify the insertion bar, 3/4-icon opening animation, final order, and exactly one added item.
- [ ] Drag items into regular, special, BBEdit project, and UpDock Auto folders.
- [ ] Verify same-dock drops into folders move items and cross-dock drops copy items.
- [ ] Build nested folders and move items into and out of the hierarchy using available controls.
- [ ] Confirm folder and special-folder menus begin with **Open Folder in Finder**.
- [ ] Test missing, moved, renamed, inaccessible, and deleted targets.

## Runtime Interaction

- [ ] Trigger each dock repeatedly from its full edge trigger zone and confirm it stays flush to the screen edge.
- [ ] Hover icons, return to the edge, and confirm the dock does not shift away from the edge.
- [ ] Test app-menu and dock-item contextual activation lists.
- [ ] Confirm holding Option while either menu is open alphabetizes nothing in Free and releasing it preserves manual order.
- [ ] Hold Shift while a dock is visible; confirm the fixed Finder, Notes, and UpDock items plus version/dock-name header appear at the leading end and disappear on release.
- [ ] Open all items, remove an item, quit a running app where offered, and show package contents only where the edition permits it.
- [ ] Test one and multiple displays, changed display arrangement, resolution/scaling changes, sleep/wake, full-screen apps, and Spaces.

## Accessibility

- [ ] Test the Accessibility starter dock, including the Apple Accessibility Guides URLs and the item that opens System Settings > Accessibility.
- [ ] Test per-dock accessibility icon size, accessible labels, and Speak on Hover independently.
- [ ] Test the application-wide Accessibility override and confirm it ignores but does not overwrite each dock's saved settings.
- [ ] Verify VoiceOver names, help text, keyboard focus order, checkboxes, menus, sheets, alerts, and help buttons.
- [ ] Confirm spoken labels stop or change appropriately as the pointer moves between the dock, items, and screen edge.

## Export, Sharing, Backups, and Recovery

- [ ] Export selected mini-docks and all settings; share a mini-dock with its preview image.
- [ ] Confirm Import is unavailable in Free and explains UpDock+ without mentioning another product.
- [ ] Confirm automatic backups are created, listed newest-first, protected when required, pruned correctly, and restorable.
- [ ] Test Diagnostics display/copy/report generation and verify sensitive information is not included.
- [ ] Confirm settings, bookmarks, custom icons, folder hierarchies, and item order survive relaunch and an app update.

## System Integrations

- [ ] Use Add Shortcuts to enumerate the Shortcuts library, select one or many shortcuts, add them within the Free item limit, and run each resulting dock item.
- [ ] Run Show Settings, Show/Hide Mini-Docks, Toggle Mini-Dock, and Open Dock Item through Shortcuts/App Intents where exposed.
- [ ] Test app-menu Show Mini-Docks, Hide Mini-Docks, Settings, About, and Quit actions.
- [ ] Confirm built-in Accessibility Settings action works while arbitrary AppleScript, shell, search, and Automator creation remain unavailable.
