orchetect/maccontrolcenterui

A **menu builder** and **suite of SwiftUI controls** that closely mimics the look, feel, and animations of **macOS Control Center** menus.

Getting Started

Swift Package Manager (SPM)

Add MacControlCenterUI as a dependency using Swift Package Manager.

- In an app project or framework, in Xcode:

Select the menu: File → Swift Packages → Add Package Dependency...

Enter this URL: https://github.com/orchetect/MacControlCenterUI

- In a Swift Package, add it to the Package.swift dependencies:

``swift .package(url: "https://github.com/orchetect/MacControlCenterUI", from: "2.7.0") ``

Import the library:

``swift import MacControlCenterUI ``

Try the Demo example project to see all of the available controls in action.

Requirements

Minimum requirements to compile: Xcode 14 on macOS 12.5 or newer.

Supports macOS 11.0+ once compiled.

Known Issues

Due to the lacklustre implementation of window resize behavior in SwiftUI, animations are kept to a bare minimum on macOS 15 and earlier. macOS 26 introduces improvements to how SwiftUI resizes windows as a result of animating view size changes, and these benefits will be conditionally available in this library when running on macOS 26.

Author

Coded by a bunch of 🐹 hamsters in a trenchcoat that calls itself @orchetect.

License

Licensed under the MIT license. See LICENSE for details.

Sponsoring

If you enjoy using MacControlCenterUI and want to contribute to open-source financially, GitHub sponsorship is much appreciated. Feedback and code contributions are also welcome.

Community & Support

Please do not email maintainers for technical support. Several options are available for issues and questions:

Questions and feature ideas can be posted to Discussions.
If an issue is a verifiable bug with reproducible steps it may be posted in Issues.

Contributions

Contributions are welcome. Posting in Discussions first prior to new submitting PRs for features or modifications is encouraged.

Code Quality & AI Contribution Policy

In an effort to maintain a consistent level of code quality and safety, this repository was built by hand and is maintained without the use of AI code generation.

AI-assisted contributions are welcome, but must remain modest in scope, maintain the same degree of quality and care, and be thoroughly vetted before acceptance.

Package Metadata

Repository: orchetect/maccontrolcenterui

Default branch: main

README: README.md