Mac Desktop Build

What This Delivers

WorkWingman currently runs exclusively on Windows computers. This build process produces an installation package that allows the application to run on Apple computers.

Why This Matters

Expanding to Apple computers allows team members and future customers who use Mac hardware to run the desktop application directly. It packages the user interface, the background service engine, and the automated browser tools into a single Mac installer.

Unsigned Software Warning

The installer is currently unsigned. Apple includes a built-in security check called Gatekeeper (Apple security system) that displays a prominent warning to anyone who downloads and opens an unsigned file. Because of this warning, the application is safe for internal team testing only and is not ready for customers. Removing this warning requires digital signing, which depends on purchasing a paid Apple Developer account that has not been purchased yet.

Modern Apple Hardware Only

The installer runs exclusively on Apple Silicon (the newer processor chips designed by Apple). It does not support older Intel-based Mac computers. Supporting older machines would require including two separate software engines, which would double the installer file size.

Profile Fields and Account Connections

A known issue exists where saving certain sensitive profile fields and connecting Google or GitHub accounts will fail on a Mac. This failure occurs because the credential storage system currently relies on a Windows-only encryption method.

Manual Build Setup

Creating the Mac package currently requires manual execution on a dedicated Mac computer. It is not yet connected to an automated CI (Continuous Integration, a system that automatically builds and tests code updates) pipeline.

Required Next Steps

Before releasing this software to outside customers, the business must purchase an Apple Developer account to sign the package, update the credential security system to work across platforms, and automate the build pipeline.