Release Notes

Every Tuck update, without the mystery.

Track recent fixes, onboarding changes, Shelf improvements, Sparkle updates, and the current notarized macOS download. Tuck stays small, private, and predictable.

Download 1.0.25 Sparkle Appcast GitHub Releases
Current: 1.0.25 build 26 macOS 14–26 Notarized DMG Zero telemetry

Shelf gains adjustable app icon spacing and new reveal gestures.

This release adds compact, default, and relaxed spacing to the Shelf itself, plus optional blank-menu-bar click and hover gestures for revealing hidden icons. The controls react immediately to Pro license changes and no longer alter spacing for other menu bar apps.

New

Three Shelf icon spacing choices

Choose Compact, Default, or Relaxed spacing for app icons displayed inside Shelf. The setting affects Shelf only; Push Mode and other apps in the macOS menu bar remain unchanged.

New

Reveal from blank menu bar space

Pro users can reveal hidden icons by clicking blank menu bar space or hovering there briefly, with safer blank-area detection that avoids app menus and occupied status items.

Improved

Clearer Free and Pro boundaries

Push Mode, Shelf Mode, and per-icon show/hide control are included in Free. Pro adds automation, app-specific rules, advanced reveal gestures, and Shelf customization.

Fixed

License-safe test isolation

Automated license tests now use an isolated Keychain service so development verification cannot disturb an activated production license.

Recommended for all users. Includes the latest notarized DMG, Sparkle metadata, and updates to the Free and Pro descriptions.

Download 1.0.25

Shelf gains custom icon order and premium Bar styles.

This release lets Pro users arrange Shelf icons with a smooth drag-and-drop interaction and choose from Capsule, Floating Glass, and Minimal Bar designs. Pro controls now fail closed at the behavior layer and update immediately when license status changes.

New

Drag Shelf icons into place

Reorder hidden menu bar icons directly inside Shelf. The dragged icon lifts under the pointer while neighboring icons animate smoothly into their new positions, and the custom order persists across relaunches.

New

Premium Shelf Bar styles

Choose Capsule, Floating Glass, or Minimal alongside the original Classic style. Capsule provides a compact rounded glass Bar inspired by modern menu bar utilities without covering the full screen.

Improved

Stronger Pro access controls

Premium styles and ordering are gated in both settings and runtime behavior. Stored preferences cannot bypass an inactive license, and an open Shelf immediately returns to Classic when Pro access ends.

Improved

Consistent settings and translations

PRO badges and upgrade links now follow one consistent title layout. New Shelf controls are localized in English, German, Spanish, French, Japanese, Simplified Chinese, and Traditional Chinese.

Recommended for everyone using Shelf. Includes the latest notarized DMG and Sparkle update metadata.

Download 1.0.24

Shelf gets custom backgrounds and smarter icon contrast.

This release adds Shelf appearance controls for users who need stronger contrast, including dark, high-contrast, and custom color backgrounds. Tuck now adapts simple template icons for readability while preserving image-style icons in their original colors.

New

Shelf background choices

Shelf mode now includes System, Dark, High Contrast, and Custom background options. Custom mode supports color and opacity controls so the panel can stay readable on bright or busy desktops.

Improved

Template icons adapt automatically

Single-color glyphs now switch between light and dark tint based on the selected Shelf background, improving contrast without requiring users to tune each icon manually.

Fixed

Bitmap icons keep their original colors

Image-style menu bar icons are no longer forced through template tinting, preventing colorful or opaque app icons from turning into unreadable black or white blocks.

Recommended for everyone using Shelf. Includes the latest notarized DMG and Sparkle update metadata.

Download 1.0.23

Shelf stays collapsed after restart and display handoff.

This release fixes a startup race where macOS could briefly report Tuck's menu bar toggle at a far-left or offscreen position after reboot, wake, or shared-display changes. Shelf mode now waits for a real settled menu bar position and repairs a broken expanded state before opening Shelf.

Fixed

Startup no longer accepts transient x=0 menu bar positions

Tuck now ignores early invalid toggle frames such as x=0/y=-26 instead of treating them as a stable boundary. That prevents Shelf mode from restoring into an expanded or unhidden state after macOS rearranges displays during launch.

Fixed

Shelf collapse self-repairs

When Shelf is already expanded because of stale startup geometry, Tuck now collapses the boundary even if the first scan finds no hidden icons. Opening Shelf also repairs the expanded section before showing the panel.

Release

Always Show checks avoid repeated no-op repair

Visible icons covered by Always Show rules are now marked protected during enforcement, so the background monitor stays quiet once those icons are already in the right place.

Previous stable download. Kept here for version history and rollback reference.

Download 1.0.22

Dragging other menu bar icons no longer breaks Shelf hide/collapse.

In Shelf mode, holding Cmd to drag any other app's menu bar icon could be misread as dragging Tuck's own toggle. That false positive force-expanded the hidden section and silently broke hide/collapse for every icon until Tuck was toggled manually again.

Fixed

Toggle-drag detection no longer over-triggers

Ordinary status-bar reflow during a cmd+drag of an unrelated icon can shift Tuck's toggle position by a few points. A too-tight threshold read that harmless jitter as a genuine drag of Tuck's own toggle, forcing the hidden section open and breaking collapse for every icon. The threshold now matches the tolerance already used elsewhere for drift compensation.

Release

Regression tests added

New tests cover both ordinary reflow jitter and a genuine drag of Tuck's toggle, so this distinction stays correct going forward.

Previous stable download. Kept here for version history and rollback reference.

Download 1.0.21

Always Show now survives OneDrive's silent reconnects.

OneDrive periodically reconnects its menu bar status item in the background (for example after a sync status change or waking from sleep). Previously Tuck only enforced an Always Show rule once, so a reconnect could leave the icon hidden even though Settings still showed the rule as active. Tuck now watches for this continuously and re-applies the rule automatically.

Fixed

Always Show recovers after OneDrive reconnects

Tuck now detects when a rule-matched item's window has changed or drifted back into the hidden zone, and automatically restores it to the visible area instead of relying on a single one-time check.

Fixed

Enforcement now runs in Push mode too

The background check that keeps Always Show rules correct previously only ran in Shelf mode; it now runs continuously regardless of which menu bar mode is active.

Release

Idempotency regression test added

A new test verifies the enforcement check never rewrites an already-correct icon position, so it can safely run every few seconds without side effects.

Previous stable download. Kept here for version history and rollback reference.

Download 1.0.20

OneDrive rules stay matched after its status text changes.

This release fixes a case where an Always Show or Always Hide rule for OneDrive could silently stop applying after the icon's sync status text changed (for example "Syncing" to "Up to date"), leaving the icon in the wrong state even though Settings still showed the rule as active.

Fixed

OneDrive icon identity no longer drifts

Tuck now keys OneDrive's menu bar identity off its stable window slot instead of its sync-status title, so a saved show/hide rule keeps matching the icon across sync status changes and relaunches.

Release

Regression coverage restored

The OneDrive identity test suite now compiles and runs as part of every release, closing a gap where these checks were silently skipped.

Recommended for everyone. Includes the latest notarized DMG and Sparkle update metadata.

Download 1.0.19

OneDrive Always Show survives restarts.

This release repairs stale macOS status-item positions for OneDrive and similar menu bar clients, so an Always Show rule can recover an icon that macOS has persisted in a hidden position.

Fixed

OneDrive restart persistence

Always Show rules now restore hidden status-item preference values at startup, including alternate OneDrive item slots that can otherwise stay hidden after app restarts.

Fixed

Rule replay is more conservative

Tuck no longer clears a rule just because the icon starts from the wrong side of the menu bar; it lets startup replay repair the position instead.

Release

Version-safe packaging

The release pipeline now reads version metadata from the Xcode project and verifies the exported app bundle before DMG packaging.

Recommended for everyone. Includes the latest notarized DMG and Sparkle update metadata.

Download 1.0.18

Menu bar mode stays dockless, and update checks show once.

This hotfix keeps Tuck out of the Dock when no foreground window is open, removes duplicate latest-version dialogs, and refreshes the notarized installer package.

Fixed

Dock icon returns to hidden mode

After Settings or update UI closes, Tuck switches back to accessory behavior so the app can keep running quietly from the menu bar.

Fixed

Update checks report once

Manual Check for Updates now presents a single Sparkle result instead of showing two latest-version dialogs.

Release

Cleaner installer package

Ships a freshly notarized DMG with the updated drag-to-Applications background and Sparkle delta metadata from build 17.

Previous stable download. Kept here for version history and rollback reference.

Download 1.0.17

Manual update checks and Settings reliably come to the front.

This hotfix restores visible Sparkle update results and fixes the app-menu Settings command so the real Tuck settings window opens in front.

Fixed

Manual update checks show their result

The Check for Updates flow now foregrounds Tuck and shows the latest-version result instead of silently finishing in the background.

Fixed

Settings opens the real settings window

The macOS app menu now routes to Tuck's Settings window and brings it forward instead of opening a blank SwiftUI settings scene.

Release

Signed update assets published

Includes a notarized and stapled DMG plus Sparkle appcast metadata for build 17.

Previous stable download. Kept here for version history and rollback reference.

Download 1.0.16

Permission setup stays complete, and Shelf drags behave correctly.

This maintenance release fixes two edge cases from the 1.0.8–1.0.9 cycle while keeping the faster local Shelf cache fallback.

Fixed

Completed onboarding stays complete

Tuck no longer reopens the permissions page after onboarding has already finished just because Accessibility is temporarily unavailable.

Fixed

Menu bar drags reconcile hidden items

Ordinary command-drags now hide newly moved items when they cross into the hidden zone instead of being mistaken for a Tuck toggle drag.

Improved

Fast Shelf open path retained

The local shelf cache fallback from 1.0.9 remains in place to reduce occasional Shelf open delay.

Release

Signed update assets published

Includes a notarized and stapled DMG plus Sparkle appcast and delta update metadata for build 11.

Historical download. Kept here for version history and rollback reference.

Download 1.0.10

First-run setup is cleaner, quieter, and easier to trust.

This release focuses on real-world installation behavior: fresh onboarding, macOS permission prompts, Shelf mode, and the Screen Recording path that makes Tuck appear correctly in System Settings.

Fixed

Permission prompts no longer pile up

Accessibility and Screen Recording requests now fire only when the user clicks the matching onboarding button.

Fixed

System dialogs stay visible

The welcome window temporarily drops behind macOS permission dialogs, then returns to its floating level after the request.

Improved

Shelf asks at the right time

Screen Recording is requested when opening Shelf without permission, not during welcome or automatic hiding.

Improved

Real app registration

The Screen Recording flow calls the macOS permission API before opening Settings so Tuck appears in the permission list.

Improved

Fresh visual onboarding

The welcome experience now uses a blue frosted-glass background that better matches Tuck's macOS utility feel.

Fixed

More complete icon scanning

Tuck now includes layer 25 menu bar windows and better fallback icons for rules and Shelf display.

Historical download. Kept here for version history and rollback reference.

Download 1.0.3

Auto-update delivery and collapsed restore behavior.

This update tightened the release pipeline and fixed restore behavior around the menu bar item used when Tuck is collapsed.

Added

Sparkle appcast release

Published notarized update assets through the Sparkle appcast for smoother in-app updates.

Changed

Version bumped to 1.0.2

Prepared the app metadata and website downloads for the second public maintenance release.

Fixed

Collapsed restore item

Tuck now uses the status item for the collapsed restore control.

Fixed

Wake alignment

Improved restore icon alignment after sleep/wake transitions.

Permission onboarding became less eager.

The first maintenance release refined startup behavior, permission copy, and Sparkle release preparation.

Fixed

No eager recording prompt

Tuck avoids asking for Screen Recording before the user reaches the relevant path.

Fixed

Services start when ready

Core services start once Accessibility permission is available, preventing premature setup work.

Improved

Permission onboarding copy

Updated localized permission text so users understand why macOS asks for each capability.

Added

Release appcast prep

Prepared the Sparkle update feed for the 1.0.1 public update.

The first public Tuck build.

Tuck launched as a lightweight macOS menu bar manager with one-click hiding, a free tier, Pro controls, and a privacy-first posture.

Added

Push Mode

Hide icons to the left of Tuck with one click, then restore them just as quickly.

Added

Shelf Mode

Show tucked icons in a panel below the menu bar on notched MacBooks.

Added

Pro controls

Auto-hide, hover reveal, app-specific Rules Mode, custom icon styles, and animation themes.

Privacy

Zero telemetry

No analytics, no tracking, and no background network activity beyond licensing and updates.

How updates are delivered

Tuck uses Sparkle for app updates. You can download the latest DMG directly from this site, or let Tuck check the signed appcast and install a notarized update from inside the app.