milanvarady/Applite

Applite is a macOS application that serves as a graphical interface for managing Homebrew casks, enabling users to discover, install, update, and uninstall software packages. It features a local SQLite database for offline search and caching, supports third-party taps, and includes tools for migrating app configurations between machines. The system also manages its own bundled Homebrew environment to simplify initial setup and provides automated pipelines for building, signing, and releasing the application.

16 changes.

This period focused on a comprehensive refactoring of Applite's user interface, replacing legacy views with new SwiftUI components for settings, app cards, and progress indicators. The work also involved modernizing the project structure by updating dependencies, streamlining the Sparkle update configuration, and removing obsolete utility modules and installation logic.

25 changes.

This period focused on a comprehensive architectural rewrite, introducing a local SQLite database for offline search and replacing the fragile Homebrew dependency with a self-contained annex. The application's interface was completely redesigned with native SwiftUI components, unified navigation, and enhanced visual feedback for tasks and errors. Supporting this core transformation were significant improvements in security, reliability, and automated release and localization tooling.

The project now includes the standard Xcode workspace structure, specifically the \contents.xcworkspacedata\ file which references the project itself, and the \IDEWorkspaceChecks.plist\ file which disables the 32-bit warning. This enables the project to be opened and built correctly in Xcode.

Applite.xcodeproj/project.xcworkspace · high confidence

The repository now includes a set of Python tooling in \Scripts/Localization\ to manage the \Localizable.xcstrings\ catalog when building from the command line. Because \xcodebuild\ does not update the catalog file directly, \sync\_catalog.py\ merges extracted keys and comments from build artifacts into the catalog, marking new keys and stale entries. \apply\_translations.py\ allows translators to apply batch updates safely, while \glossary\_audit.py\ checks translations against the project glossary and \apple\_terms.py\ helps verify terminology consistency with macOS system strings.

Scripts/Localization · high confidence

Users can now export their installed apps to a Brewfile and selectively choose which apps to reinstall on another Mac. The new App Migration screen provides Export and Import cards; exporting generates a Brewfile with tap and cask lines, while importing parses the file, resolves tokens against the local database, and presents a selection sheet to confirm which apps to install. This replaces the previous behavior where imports were automatically applied without user selection, ensuring users can review and control the installation process.

Applite/Features/AppMigration · high confidence

The Scripts/Release directory now contains a complete, automated release tooling suite. This includes a main orchestration script (release.sh) that handles building, signing with Developer ID, notarization, DMG packaging, and publishing to GitHub and the Sparkle appcast. The pipeline introduces a two-stage gate process: first for writing release notes, and second for publishing those notes to the applite.app static site. Supporting scripts manage appcast updates (appcast\_insert.py), note conversion for the website (notes\_to\_markdown.py), DMG background generation (make\_dmg\_background.swift), and pre-flight checks for credentials and toolchain (preflight.sh). An ExportOptions.plist configures manual signing for the Developer ID distribution method.

Scripts/Release · high confidence

A new shell script in Scripts/Screenshots now adds visible edges to raw window screenshots used in the GitHub README. It applies a drop shadow to light-mode images and a light hairline to dark-mode images, ensuring the window chrome remains distinct against both GitHub's light and dark backgrounds. The script uses ImageMagick to derive these effects from the PNG alpha channel, preserving rounded corners, and outputs the framed images to a specified directory.

Scripts/Screenshots · high confidence

Applite now persists cask data locally using a GRDB-managed SQLite database, enabling offline access and full-text search via FTS5. The schema keys casks by their full tap-qualified token to prevent identity collisions across different taps, and includes fields for warnings (deprecated, disabled, caveats) and download analytics. Database initialization is performed asynchronously on a background thread to prevent blocking the main UI thread during app launch, and the service layer handles syncing cask records from the API while maintaining search index consistency.

Applite/Core/Database · high confidence

The Discover feature now presents apps organized by category in a new layout. Each category section displays a horizontal, scrollable row of apps with left/right navigation arrows, and users can change the sorting order of these apps via a new category sorting option in the toolbar. The view also includes a 'See All' link to navigate to the full category detail view.

Applite/Features/Discover · high confidence

This update introduces several new SwiftUI components to enhance the user interface. Users can now configure a custom installation directory via the new AppdirSelectorView, which allows selecting a specific folder for app installations. App cards feature a redesigned action interface using CardActionPill for a modern, App Store-style interaction, supported by a reusable Card container and a SuccessCheckmark animation for action feedback. Additionally, the interface includes a CategorySortingToolbar for managing app list order, a CircularProgressRing for visual download progress, and utility views like InfoPopup and Remark to improve settings clarity and accessibility.

Applite/Components · high confidence

This update introduces several new Swift extensions to the Applite codebase: Array gains a safe subscript to prevent out-of-bounds access, Font adds predefined Applite-specific title styles, String includes helpers for copying to the clipboard, cleaning terminal output (removing ANSI codes and backspaces), limiting line count, and counting lines, and View provides a generic modifier helper. Additionally, URL gains a method to return a quoted path. The Bundle extension has been refactored to safely unwrap version and build number strings, returning "N/A" instead of force-unwrapping, which prevents potential crashes if these keys are missing.

Applite/Extensions · high confidence

The search interface now performs a debounced (200ms) Full-Text Search 5 (FTS5) query as the user types, cancelling previous requests to avoid race conditions. Users can control the display of results via a toolbar menu that allows sorting by best match, alphabetical order, or download count, and includes toggles to hide apps with low download counts or those marked as disabled.

Applite/Features/Search · high confidence

The AppView SwiftUI component, which previously displayed application icons, names, descriptions, and controls for installing, updating, and uninstalling apps, has been removed from the application. This deletion eliminates the specific UI logic for managing individual app states (such as download progress, success animations, and error alerts) within this view file.

Applite/Views/App Views · high confidence

The dedicated SwiftUI view for triggering application updates (CheckForUpdatesView) has been removed from the Sparkle Updater component. This change eliminates the specific UI element that previously presented a "Check for Updates…" button to users, indicating that the update checking interface is no longer handled by this specific file.

Applite/Components/Sparkle Updater · high confidence

The legacy detail views for Homebrew management, categories, discovery, downloads, and updates have been removed from the application. This cleanup eliminates the old SwiftUI implementations for managing Homebrew installations, browsing app categories, discovering new apps, searching for casks, and updating outdated software, indicating a shift to a different UI structure or view hierarchy elsewhere in the app.

Applite/Views/Detail Views · high confidence

The standalone Swift files for verifying the Homebrew installation path (\isBrewPathValid.swift\) and checking for Xcode Command Line Tools (\isCommandLineToolsInstalled.swift\) have been deleted. This removes the previous implementation that validated the brew executable path and checked tool installation status via direct shell calls, indicating these specific verification functions are no longer used or have been replaced by a different mechanism elsewhere in the application.

Applite/Utilities/Verify Brew Installation · high confidence

The legacy Homebrew installation implementation, including the \BrewInstallation\ struct and its associated \BrewInstallationProgress\ observable, has been removed from the application. This change eliminates the code responsible for installing Xcode Command Line Tools and fetching the Homebrew tarball into the application's support directory, indicating that this functionality is no longer handled by this specific utility module.

Applite/Utilities/Brew Installation · high confidence

The legacy shell execution components in Applite/Utilities/Shell have been removed. This includes the synchronous and asynchronous \shell\ functions, the \ShellOutputStream\ class for real-time command output streaming, and the \ShellResult\ struct. These files are deleted, indicating that the application no longer uses this specific implementation for running shell commands.

Applite/Utilities/Shell · high confidence

The project now includes a default Xcode scheme (Applite.xcscheme) that configures the build, test, launch, profile, analyze, and archive actions. This ensures that developers have a consistent starting point for running and testing the application, with the launch action set to Debug configuration and the archive action set to Release.

Applite.xcodeproj/xcshareddata · high confidence

The app now stops running Homebrew tasks before quitting to prevent orphaned processes, and displays Applite's icon in the sudo password prompt. Sparkle update checks are bridged into a shared observable model to provide consistent UI feedback and prevent stacked requests. The menu bar has been restructured: it now includes a 'Refresh App Catalog' command, links point to the new applite.app domain (with added GitHub, Discord, and Sponsor links), and the uninstall window has been renamed and redesigned. Additionally, dedicated windows for terminal output and cask info are now available.

Applite/App · high confidence

The Brew core module has been reorganized into dedicated services (BrewService, InstalledCaskService, BrewPaths) to manage Homebrew operations more robustly. Command execution now uses strict argv-based invocation to prevent shell injection, and the app icon is displayed in the sudo password prompt for better clarity. Users will see a "Waiting…" label for queued operations, and failed casks remain visible in Active Tasks until dismissed. Additionally, install and uninstall commands now always use the --force flag to handle partial or untracked installations more gracefully.

Applite/Core/Brew · high confidence

Applite now installs its own Homebrew instance (the "annex") directly from a tarball on first launch, eliminating the previous requirement for the Xcode Command Line Tools and the interactive onboarding flow. This change relies on Homebrew 6.0.12+ native CLT-free support and includes a lightweight \git\ shim to satisfy Homebrew's availability checks. The new bootstrap process is non-destructive: it repairs a broken annex in-place by overlaying a fresh tarball, preserving user-installed casks, and uses atomic staging swaps to prevent data loss during updates. Users are presented with a single, non-dismissable setup overlay that tracks the installation phase and provides a clear escape hatch to use their own Homebrew installation if the annex fails or is unsuitable.

Applite/Core/Brew/Installation · high confidence

The Active Tasks view now requires explicit user confirmation before cancelling a bulk install or update. When the Stop button is tapped, a dialog appears asking the user to confirm stopping the remaining tasks, clarifying that already completed apps will remain installed while the rest are cancelled.

Applite/Features/ActiveTasks · high confidence

The application's infrastructure layer has been reorganized into a dedicated Core/Infrastructure folder, introducing several key capabilities and fixes. A new AlertManager provides per-window alert queuing to prevent overlapping dialogs and ensure users see all error summaries, while a type-safe UpdaterViewModel bridges Sparkle's KVO-based updater to SwiftUI's observation system for accurate update status tracking. Network handling is improved with a DownloadSizeProbe that accurately reports artifact sizes via HEAD and range requests, and a MirrorEnvironment that correctly filters out empty proxy variables to avoid Homebrew configuration issues. Additionally, the notification system has been modernized to use async/await and type-safe preferences to prevent silent suppression of failure alerts, and the uninstall process now safely orders Homebrew removal before data deletion to prevent partial uninstall states.

Applite/Core/Infrastructure · high confidence

Applite now uses a dedicated AppleScript helper (askpass.js) to display a password prompt with the Applite icon when sudo operations are required, ensuring the password is passed directly to sudo without passing through the app's memory. Additionally, the app can now load cask metadata from third-party Homebrew taps by bypassing Brew 6's trust checks for read-only operations, and the bundled categories.json has been significantly expanded with new categories like AI and Gaming, plus many more apps added to existing sections.

Applite/Resources · high confidence

The application now uses a centralized navigation structure in the \ContentView\ that manages a sidebar (\SidebarView\) for selecting sections like Discover, Updates, Installed apps, Active Tasks, and Homebrew settings, alongside a detail pane (\DetailView\) that renders the corresponding content. A new search feature allows users to filter apps directly from the sidebar, with logic to restore the previous view when the search is cleared. Additionally, a single, root-level alert queue ensures that errors (such as Homebrew setup failures) are presented consistently at the window level rather than being lost in nested views.

Applite/Navigation · high confidence

The BrewPathSelector view now uses modern SwiftUI patterns, replacing the manual debounced text field with a native file importer button for selecting custom brew paths. Path validation logic has been moved to async tasks, improving responsiveness, and preference keys are now sourced from a centralized type-safe configuration. The UI also reflects updated labeling, such as renaming the default option to 'Applite's installation' for the annex path.

Applite/Components/BrewPathSelector · high confidence

Applite now displays a non-dismissable modal overlay during the initial setup to manage the installation of its bundled Homebrew environment. This interface replaces the previous first-run onboarding flow, providing real-time status updates and distinct visual states for success, failure, or when a user-selected Homebrew path is missing. The view includes specific troubleshooting guidance and links to the Applite support site if the installation encounters issues.

Applite/Features/Bootstrap · high confidence

Users can now sort apps within categories by most downloaded or alphabetically (A–Z), with the preference stored globally. The app also displays richer cask details, including deprecation and disable status, full tokens, and tap information, while category data is now loaded from a remote catalog with a bundled fallback for reliability.

Applite/Core/Models · high confidence

The Cask Info window now uses a native grouped Form layout to display cask details, including a new feature that probes and shows the actual download size of the artifact. Additionally, a new Error Window has been introduced to display terminal output from failed operations, providing users with a dedicated view to copy error logs for issue reporting.

Applite/Windows · high confidence

The Homebrew management screen has been redesigned into a native grouped Form, introducing dedicated sections to refresh or reinstall Applite's bundled Homebrew installation with clearer warnings and success feedback, alongside a new info panel displaying the Homebrew version and installed cask count. Additionally, the Installed apps view now uses local filtering instead of the Fuse library for search, providing immediate results and a dedicated empty-state view when no apps match the query.

Applite/Features/BrewManagement · high confidence

The Settings window has been completely redesigned to use SwiftUI's native grouped Form style, replacing the previous layout. This change introduces several new configuration capabilities: users can now configure network mirrors with presets for USTC, Tsinghua, and Aliyun; enable a system proxy with protocol selection; and toggle 'Greedy Upgrades' to include self-updating apps in catalog updates. The Brew settings pane now features a dedicated recovery mechanism for invalid Homebrew paths and a persistent banner prompting catalog refreshes when relevant settings change. Additionally, the General settings pane includes a workaround to ensure the color scheme preference applies correctly, and the Uninstall view has been restructured with clearer warnings and options for removing Homebrew cache.

Applite/Features/Settings · high confidence

The app card UI has been redesigned to use native, rounded-corner icons that display a deterministic monogram fallback when remote images fail, replacing the previous third-party favicon approach. Action buttons (Install, Update, Open) are now styled as App Store-style pills, and the options menu is accessible via right-click context menus in addition to the ellipsis button. The layout also includes improved warning indicators for caveats, deprecation, and disabled casks, along with smoother entry/exit animations for cards in the grid.

Applite/AppViews · high confidence

The Cask model and its associated data loading logic have been refactored. The previous implementation files (Cask.swift, CaskData.swift, and CaskDataLoadError.swift) have been removed, indicating a structural change to how cask data is modeled, fetched from the Homebrew API, cached, and parsed. This change likely improves the robustness of data loading and error handling for cask operations.

Applite/Model · medium confidence

The application has removed several legacy SwiftUI views and styles, including the main \ContentView\, the initial \SetupView\, the \SettingsView\, the \UninstallSelfView\, and the \BigButtonStyle\. This cleanup eliminates the old onboarding flow, the previous settings interface, the standalone uninstaller view, and the custom button styling utility, indicating a structural refactor of the user interface.

Applite/Views · high confidence

The application has removed several internal utility components: BrewPaths (which managed Homebrew executable and directory paths), DebounceObject (which handled text field debouncing via Combine), and UninstallSelf (which performed the app uninstallation and cleanup). These changes indicate a shift in how the application manages Homebrew integration, user input handling, and self-removal logic.

Applite/Utilities · high confidence

The application's automatic update behavior has been streamlined: the manual downloader and installer launcher services are no longer required, and automatic update checks are now enabled by default. Additionally, the app no longer requires special sandboxing exceptions for Sparkle's Mach services, simplifying the security profile. The update feed URL has also been corrected to point to the proper repository path.

Applite · high confidence

The application now uses a centralized, type-safe system for managing user preferences, ensuring that default values are defined in a single source of truth to prevent configuration drift. This change introduces a new 'Catalog Update Frequency' setting, allowing users to choose how often the app checks for software updates (options include every app launch, every three days, weekly, or monthly). Additionally, the preference system now supports category sorting options and manages settings for Brew paths, proxy configurations, and mirrors through this unified interface.

Applite/Core/Preferences · high confidence

The app now uses a multi-strategy locator to find installed applications, fixing issues where launch failed because the bundle filename differed from the Homebrew display name (common with .pkg casks). Instead of relying on a single shell command, the system checks the Caskroom symlink, the exact bundle name from cask metadata, a display-name guess, and finally the LaunchServices bundle identifier, ensuring apps open reliably even when their on-disk location is non-standard.

Applite/Core/CaskCore · high confidence

The Updates view now correctly keeps the 'Update All' button disabled while a bulk update is in progress, even if the user switches tabs and returns, by syncing the button's disabled state with the observable batch progress rather than relying solely on local view state. Additionally, the refresh button in the toolbar now handles errors internally to prevent a loop where dismissing an alert immediately re-presents it, and the empty state view provides a dedicated retry option when the initial check for updates fails.

Applite/Features/Updates · high confidence

Added a new Python-based test harness (\applite\_test.py\) in the \Testing\ directory to exercise Applite's Homebrew integration via guided manual passes. The harness supports multiple rounds (annex brew, external brew, upgrade from v1.3.1, and self-uninstall) and verifies real-world side effects—such as cask installation, updates, batch operations, and tap handling—by checking the Homebrew CLI and filesystem state after each user-performed action. It includes documentation (\README.md\, \TRIAGE.md\, \review-findings.md\) detailing the test strategy, known findings, and safety constraints for running on a throwaway VM.

Testing · high confidence

The Applite Xcode project has been configured with a new structure, integrating several key Swift packages: ButtonKit for UI components, Kingfisher for image loading, Shimmer for loading animations, Sparkle for application updates, and GRDB for local database management. The project also includes localization support via Localizable.xcstrings and is set up to build the Applite.app target.

Applite.xcodeproj · high confidence

The application's update feed (appcast.xml) now lists version 1.4.2 (build 21) as the latest release, replacing the previous 1.4.0 entry. The third-party license file (LICENSE-3RD-PARTY.txt) has been updated to reflect the current pinned dependency versions, specifically ButtonKit 0.7.1, GRDB.swift 7.10.0, Kingfisher 8.9.0, Sparkle 2.9.0, and SwiftUI-Shimmer 1.5.1.

(repo-wide) · high confidence

Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

• CAI 44 → 54 (+9.4)
• Rubric changed (rubric-2026.08.15 → rubric-2026.09.15) — scores are not directly comparable.

• Code Health 95 → 92 (-2.4)
• Architecture 69 → 96 (+27.3)
• Maturity 57 → 58 (+1.8)
• Readiness 17 → 26 (+8.9)
• Security 97 → 100 (+2.5)
• Domain Modelling 100 (new)

• Coverage not measured — test suite did not build
• Dimension evaluation failed
• LLM evaluation failed
• Medium: security finding (details withheld)
• No exposed public API
• No tests found
• Test reliability not included

• BrewService.applyBatchLine (cognitive 24) (Applite/Core/Brew/BrewService.swift)
• BrewService.applyBatchLine (cyclomatic 18) (Applite/Core/Brew/BrewService.swift)
• BrewService.reconcileBatch (cognitive 28) (Applite/Core/Brew/BrewService.swift)
• BrewService.reconcileBatch (cyclomatic 16) (Applite/Core/Brew/BrewService.swift)
• BrewService.runBatchOperation (cognitive 21) (Applite/Core/Brew/BrewService.swift)
• CaskInfoWindowView.body (cognitive 18) (Applite/Windows/CaskInfoWindowView.swift)
• Change coupling: DetailView.swift ↔ SidebarView.swift (Applite/Navigation/DetailView.swift)
• ClassTooLong: BrewService (Applite/Core/Brew/BrewService.swift)
• Duplicated block (20 lines × 2) (Applite/Features/AppMigration/ExportAppsView.swift)
• Duplicated block (23 lines × 2) (Applite/Core/Brew/BrewService.swift)
• Duplicated block (9 lines × 2) (Applite/Features/Installed/InstalledView.swift)
• Hotspot: Applite/Core/Brew/BrewService.swift (Applite/Core/Brew/BrewService.swift)
• Hotspot: Applite/Core/Brew/Shell.swift (Applite/Core/Brew/Shell.swift)
• Hotspot: Applite/Core/Infrastructure/NetworkProxyManager.swift (Applite/Core/Infrastructure/NetworkProxyManager.swift)
• InstalledAppLocator.bundleIdentifier (cognitive 24) (Applite/Core/CaskCore/InstalledAppLocator.swift)
• MethodTooLong: Shell.makeStream (Applite/Core/Brew/Shell.swift)
• NetworkProxyManager.getSystemProxySettings (cognitive 26) (Applite/Core/Infrastructure/NetworkProxyManager.swift)
• NetworkProxyManager.getSystemProxySettings (cyclomatic 24) (Applite/Core/Infrastructure/NetworkProxyManager.swift)
• No ADRs found
• Off-boarding risk: anonymized user #1
• …and 12 more

• 19 commits — 18 feature/other, 1 fixes

• Applite/Core — 5 commits
• (repo) — 4 commits
• (root) — 3 commits
• Applite.xcodeproj/project.pbxproj — 2 commits
• Scripts/Release — 2 commits
• docs/screenshots — 2 commits
• .github/FUNDING.yml — 1 commit

• fix: Fix updates never being detected on a stale metadata cache
• change: Appcast: 1.4.2 (build 21)
• change: Cask info: show the download size
• change: Don't let a failed annex repair destroy the apps it was protecting
• change: Give the README screenshots a visible edge
• change: Merge pull request #161 from milanvarady/funding-kofi
• change: Merge pull request #162 from milanvarady/update-in-app-links
• change: Merge pull request #163 from milanvarady/release-docs-followup
• change: Merge pull request #164 from milanvarady/readme-badges-screenshots
• change: Point the annex tarball at Homebrew's main branch
• change: Point the in-app links at applite.app
• change: Publish release notes to applite.app instead of the Vapor app
• change: README: point at applite.app and the new email address
• change: Release 1.4.1 (build 20)
• change: Release 1.4.2 (build 21)
• change: Repair a broken annex in place instead of wiping the user's apps
• change: Swap PayPal for Ko-fi in the Sponsor button
• change: Trim README badges and add light/dark screenshot
• change: Update the release docs and notes template for applite.app

Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

milanvarady/Applite was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.