v1.4.1

Fixed

• About page now shows the correct version number — Info.plist was using a hardcoded 1.2.0 instead of the build variable $(MARKETING_VERSION); version is now derived from the Xcode project's MARKETING_VERSION at build time

Changed

• CONTRIBUTING.md expanded with project architecture, layer rules, naming conventions, concurrency model, shell command safety rules, path resolution guide, security patterns, feature-addition guides, and test coverage map

Full Changelog: v1.4.0...v1.4.1

v1.4.0

New Features

• Services panel moved from main menu into Preferences for a cleaner menu bar experience
• Inline status notices when starting, stopping, or restarting services (busy → success/failure → auto-clear)
• New Diagnostics panel in Preferences showing service health checks and recent nginx/PHP-FPM error log tail
• Services that require root (e.g. dnsmasq) now auto-escalate — opens Terminal with the correct sudo command instead of silently failing
• MySQL now appears in the services list with live status

Bug Fixes

• Fixed dnsmasq always showing red — was checking TCP port 53; dnsmasq uses UDP, now uses process check instead
• Fixed PHP-FPM status showing green after a crash — stale socket files were causing false positives; now uses pgrep on the FPM config path
• Fixed Preferences window not being resizable
• Fixed Preferences navigation showing as overflow tab bar on macOS 26 — replaced TabView with NavigationSplitView

v1.3.1

Fixed

• WordPress auto-login no longer fails with "No administrator found" when WP-CLI prints PHP deprecation/warning notices to stdout before the user ID — those lines are now filtered out before parsing

Full Changelog: v1.3.0...v1.3.1

1.3.0 — WordPress one-click admin login

What's new

WordPress one-click admin login

Expand any WordPress site in the Sites panel to find two new actions:

• Login as Admin — generates a one-time login token via WP-CLI, opens your default browser, and lands you directly in wp-admin already authenticated
• Copy Login URL — same token, copied to clipboard so you can paste it into any browser (great for cross-browser testing)

Tokens are single-use and expire after 2 minutes. The feature auto-installs a small valetui-local-dev.php mu-plugin on first use for sites not created by ValetUI's WordPress installer — safe to keep, has no effect on production.

Works with any local WordPress site (detected via wp-config.php). Requires WP-CLI (brew install wp-cli).

Bug fix

WP-CLI commands now correctly resolve the MySQL Unix socket when invoked from the app process, where localhost does not automatically map to the socket (unlike in a shell session).

Requirements

• macOS 14.0+
• Laravel Valet
• WP-CLI (brew install wp-cli) — for WordPress login feature only

v1.2.0 — Floating Panel UI & Terminal Overhaul

Install

Download (Recommended)

1. Download ValetUI.dmg from the assets below
2. Open the DMG and drag ValetUI to Applications
3. Launch from Applications

First launch warning: macOS may block the app since it's not notarized.

• macOS 15 (Sequoia)+ — open once, dismiss the warning, then System Settings → Privacy & Security → Open Anyway
• macOS 14 and earlier — right-click the app → Open → Open
• Or run: xattr -d com.apple.quarantine /Applications/ValetUI.app

Build from Source

git clone https://github.com/NaveenKharwar/ValetUI.git
cd ValetUI
open ValetUI.xcodeproj

Select your Development Team in Signing & Capabilities, then press ⌘R.

---

What's New

UI overhaul

• Switched from native menu style to a floating card panel — real window with a header showing PHP version, site count, and Valet status
• Custom app icon and menu bar icon (valet ticket + V mark design); menu bar icon shows a live green/red status dot
• Site expanded actions redesigned into grouped cards — Open / Manage / Danger sections with dividers and borders
• All navigation replaced with @State-based routing — no more whitespace, toolbar flicker, or fixed heights
• PHP panel footer: "Want more PHP versions?" hint with a one-click copy of the brew install command
• Preferences pickers now show instant confirmation ("Default terminal is set to iTerm2")
• About tab added to Preferences with app icon, version, and GitHub links

Terminal integration rewrite

• Auto-discovers installed terminals by bundle ID — iTerm2, Warp, Ghostty, Alacritty, WezTerm, Kitty, and more found wherever installed (no hardcoded paths)
• Always opens a new window instead of a tab
• Uses NSWorkspace + a temp .command bash script — no AppleScript, no escaping issues, works with every terminal
• Share Publicly now sources ~/.zshrc so PATH (including Composer's valet binary) is set correctly

Fixes

• All rows now fully clickable — .contentShape(Rectangle()) applied everywhere
• PHP version picker inside site detail fully clickable (arrow and empty space now work)
• Preferences window always comes to front when opened
• About tab copyright year and version are now dynamic from bundle

Cleanup

• Removed 7 dead *MenuView files replaced by panel views
• Removed all frame(height:) manual sizing — panel windows size dynamically from content

v1.1.1

Install

1. Download ValetUI-v1.1.1.dmg, open it, drag ValetUI to Applications
2. First launch: macOS will warn that the app is from an unidentified developer (it is ad-hoc signed, not notarized — this is expected for a free open-source build)
   • macOS 15 (Sequoia) and later: open the app once, dismiss the warning, then go to System Settings → Privacy & Security and click Open Anyway
   • macOS 14 and earlier: right-click the app → Open → Open
3. Or skip the warning entirely from Terminal:

   xattr -d com.apple.quarantine /Applications/ValetUI.app
   

v1.1.0

Install

1. Download ValetUI-v1.1.0.dmg, open it, drag ValetUI to Applications
2. First launch: macOS will warn that the app is from an unidentified developer (it is ad-hoc signed, not notarized — this is expected for a free open-source build)
   • macOS 15 (Sequoia) and later: open the app once, dismiss the warning, then go to System Settings → Privacy & Security and click Open Anyway
   • macOS 14 and earlier: right-click the app → Open → Open
3. Or skip the warning entirely from Terminal:

   xattr -d com.apple.quarantine /Applications/ValetUI.app