Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/DigiDNA/ColorSet

ColorSet is a macOS utility and framework allowing developers to manage custom interface colors with ease.
https://github.com/DigiDNA/ColorSet

Last synced: about 2 months ago
JSON representation

ColorSet is a macOS utility and framework allowing developers to manage custom interface colors with ease.

Host: GitHub
URL: https://github.com/DigiDNA/ColorSet
Owner: DigiDNA
License: mit
Created: 2018-06-25T15:03:52.000Z (almost 6 years ago)
Default Branch: main
Last Pushed: 2023-10-25T10:29:33.000Z (8 months ago)
Last Synced: 2024-03-27T01:02:26.044Z (3 months ago)
Language: Swift
Homepage: https://imazing.com/colorset
Size: 4.83 MB
Stars: 199
Watchers: 16
Forks: 17
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md

Lists

awesome-stars - ColorSet
my-awesome-starred - DigiDNA/ColorSet - ColorSet is a macOS utility and framework allowing developers to manage custom interface colors with ease. (Swift)
awesome-stars - ColorSet
my-awesome-stars - DigiDNA/ColorSet - ColorSet is a macOS utility and framework allowing developers to manage custom interface colors with ease. (Swift)
awesome-stars - DigiDNA/ColorSet - ColorSet is a macOS utility and framework allowing developers to manage custom interface colors with ease. (Swift)
awesome-stars - DigiDNA/ColorSet - ColorSet is a macOS utility and framework allowing developers to manage custom interface colors with ease. (Swift)
open-source-mac-os-apps - ColorSet - ColorSet is a macOS utility and framework allowing developers to manage custom interface colors with ease. ![swift_icon] ![c_sharp_icon] ![objective_c_icon] (Applications / Graphics)

README

        ColorSet

========

[![Build Status](https://img.shields.io/github/workflow/status/DigiDNA/ColorSet/ci-mac?label=macOS&logo=apple)](https://github.com/DigiDNA/ColorSet/actions/workflows/ci-mac.yaml)

[![Build Status](https://img.shields.io/github/workflow/status/DigiDNA/ColorSet/ci-win?label=Windows&logo=windows)](https://github.com/DigiDNA/ColorSet/actions/workflows/ci-win.yaml)

[![Issues](http://img.shields.io/github/issues/DigiDNA/ColorSet.svg?logo=github)](https://github.com/DigiDNA/ColorSet/issues)

![Status](https://img.shields.io/badge/status-active-brightgreen.svg?logo=git)

![License](https://img.shields.io/badge/license-mit-brightgreen.svg?logo=open-source-initiative)  

[![Contact](https://img.shields.io/badge/[email protected]?logo=twitter&style=social)](https://twitter.com/DigiDNA)

About

-----

**`ColorSet` is a macOS utility and framework allowing developers to manage custom interface colors with ease.**

### Rationale

As of macOS 10.14 Mojave, Apple introduced a system-wide dark-mode.  

Applications linked with the macOS 10.14 SDK now need to react to system appearance changes.

While built-in AppKit UI elements handle this perfectly, an application often relies on custom controls, custom drawing code, or at last custom colors.

As an example, the following code will perfectly react to the dark mode.  

This is a system color, so everything is handled automatically by AppKit:

    let color = NSColor.textColor

While the following won't change, as the color components are hard-coded:

     let color = NSColor( deviceRed: 1, green: 0, blue: 0, alpha: 1 )

     

Apple provides a nice solution, relying on Asset Catalog files.  

As of Xcode 10, you can create custom colors in Asset Catalogs, identified by a name, and optionally containing variants for a specific UI theme or device.

**Unfortunately, this feature is only available for applications running on macOS 10.13 and later.**  

It basically means you'll have to drop support for macOS 10.12 and below.

If you need to support macOS 10.12 or below, **Apple's official recommendation (as seen during WWDC18) is to actually hard-code colors using conditional platform-detection code**.

**So here comes `ColorSet`.**

### ColorSet & ColorSetKit

`ColorSet` is both a macOS application and a macOS Swift framework, `ColorSetKit`.

The application lets you create files containing colors and variants, just as an Asset Catalog File, while the framework allows you, in your application, to retrieve colors from the `.colorset` file using names, just like the macOS 10.13 SDK.

### Creating a `.colorset` file

The application lets you create as many colors as you want, each with a unique name.  

For each color, an optional dark variant can be set:

![ColorSet](Assets/ColorSet.png "ColorSet")

### Using ColorSetKit

By default, `ColorSetKit` will look for a file named `Colors.colorset` in your application's bundle.

Colors can be retrieved using a custom method on `NSColor`:

    let color = NSColor.colorFromColorSet( "MyCustomColor" )

By themselves, colors won't react to UI theme changes.  

But the `colorFromColorSet` method will return the correct color, based on the current UI theme.

This means that if you use custom drawing code, you shouldn't cache color objects, but instead call `colorFromColorSet` directly from your drawing code.  

This way, the correct color will be used each time your view is redrawn (which happens automatically when the UI theme changes).

License

-------

**`ColorSet` is released under the terms of the MIT license.**

Repository Infos

----------------

    Owner:   DigiDNA

    Web:     www.digidna.net

    Blog:    imazing.com/blog

    Twitter: @DigiDNA

    GitHub:  github.com/DigiDNA