{"id":15719623,"url":"https://github.com/jordanbaird/colorwellkit","last_synced_at":"2025-04-16T05:50:38.620Z","repository":{"id":198947203,"uuid":"701841953","full_name":"jordanbaird/ColorWellKit","owner":"jordanbaird","description":"A versatile alternative to NSColorWell for Cocoa and ColorPicker for SwiftUI","archived":false,"fork":false,"pushed_at":"2024-05-26T09:16:45.000Z","size":1555,"stargazers_count":27,"open_issues_count":1,"forks_count":4,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-24T14:47:55.765Z","etag":null,"topics":["apple","cocoa","color-picker","color-well","colorpickerview","colors","macos","nscolorwell","swift","swift-package-manager","swiftui","swiftui-components"],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jordanbaird.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"jordanbaird","buy_me_a_coffee":"jordanbaird"}},"created_at":"2023-10-07T18:06:20.000Z","updated_at":"2025-01-15T00:54:51.000Z","dependencies_parsed_at":"2024-10-24T15:29:19.640Z","dependency_job_id":"81100a70-fc39-4501-87bb-6e0aea671a09","html_url":"https://github.com/jordanbaird/ColorWellKit","commit_stats":{"total_commits":48,"total_committers":1,"mean_commits":48.0,"dds":0.0,"last_synced_commit":"4eb3156be36c74bcf401f5fc06827901c3ad715d"},"previous_names":["jordanbaird/colorwellkit"],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jordanbaird%2FColorWellKit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jordanbaird%2FColorWellKit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jordanbaird%2FColorWellKit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jordanbaird%2FColorWellKit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jordanbaird","download_url":"https://codeload.github.com/jordanbaird/ColorWellKit/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249204909,"owners_count":21229829,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["apple","cocoa","color-picker","color-well","colorpickerview","colors","macos","nscolorwell","swift","swift-package-manager","swiftui","swiftui-components"],"created_at":"2024-10-03T21:56:23.077Z","updated_at":"2025-04-16T05:50:38.580Z","avatar_url":"https://github.com/jordanbaird.png","language":"Swift","funding_links":["https://github.com/sponsors/jordanbaird","https://buymeacoffee.com/jordanbaird"],"categories":[],"sub_categories":[],"readme":"# ColorWellKit\n\n[![Continuous Integration][ci-badge]](https://github.com/jordanbaird/ColorWellKit/actions/workflows/test.yml)\n[![Release][release-badge]](https://github.com/jordanbaird/ColorWellKit/releases/latest)\n[![Swift Versions][versions-badge]](https://swiftpackageindex.com/jordanbaird/ColorWellKit)\n[![Docs][docs-badge]](https://swiftpackageindex.com/jordanbaird/ColorWellKit/documentation)\n[![License][license-badge]](LICENSE)\n\nA versatile alternative to `NSColorWell` for Cocoa and `ColorPicker` for SwiftUI.\n\n\u003cdiv align=\"center\"\u003e\n    \u003cimg src=\"Sources/ColorWellKit/Documentation.docc/Resources/color-well-with-popover-dark.png\" style=\"width:37%\"\u003e\n    \u003cimg src=\"Sources/ColorWellKit/Documentation.docc/Resources/color-well-with-popover-light.png\" style=\"width:37%\"\u003e\n\u003c/div\u003e\n\nColorWellKit is designed to mimic the appearance and behavior of the color well designs introduced in macOS 13 Ventura, ideal for use in apps that are unable to target the latest SDK. While a central goal of ColorWellKit is to maintain a similar look and behave in a similar way to Apple's design, it is not intended to be an exact clone. There are a number of subtle design differences ranging from the way system colors are handled to the size of the drop shadow. In practice, there are very few notable differences:\n\n\u003cdiv align=\"center\"\u003e\n    \u003cimg src=\"Sources/ColorWellKit/Documentation.docc/Resources/design-comparison-dark.png\" style=\"width:49%\"\u003e\n    \u003cimg src=\"Sources/ColorWellKit/Documentation.docc/Resources/design-comparison-light.png\" style=\"width:49%\"\u003e\n\u003c/div\u003e\n\n## Install\n\nAdd the following dependency to your `Package.swift` file:\n\n```swift\n.package(url: \"https://github.com/jordanbaird/ColorWellKit\", from: \"1.1.2\")\n```\n\n## Usage\n\n[Read the full documentation here](https://swiftpackageindex.com/jordanbaird/ColorWellKit/documentation)\n\n### SwiftUI\n\nCreate a `ColorWell` and add it to your view hierarchy. There are a wide range of initializers and modifiers to choose from, allowing you to set the color well's color, label, and style.\n\n```swift\nimport SwiftUI\nimport ColorWellKit\n\nstruct ContentView: View {\n    @Binding var textColor: Color\n\n    var body: some View {\n        VStack {\n            ColorWell(\"Text Color\", selection: $textColor)\n                .colorWellStyle(.expanded)\n\n            MyCustomTextEditor(textColor: $textColor)\n        }\n    }\n}\n```\n\n### Cocoa\n\nCreate a `CWColorWell` using one of the available initializers, or use an `IBOutlet` to create a connection to a Storyboard or NIB file. Respond to color changes using your preferred design pattern.\n\n```swift\nimport Cocoa\nimport ColorWellKit\n\nclass ViewController: NSViewController {\n    @IBOutlet var colorWell: CWColorWell!\n    @IBOutlet var textEditor: NSTextView!\n\n    override func viewDidLoad() {\n        colorWell.style = .expanded\n        if let textColor = textEditor.textColor {\n            colorWell.color = textColor\n        }\n    }\n\n    @IBAction func updateTextColor(sender: CWColorWell) {\n        textEditor.textColor = sender.color\n    }\n}\n```\n\n## License\n\nColorWellKit is available under the [MIT license](LICENSE).\n\n[ci-badge]: https://img.shields.io/github/actions/workflow/status/jordanbaird/ColorWellKit/test.yml?branch=main\u0026style=flat-square\n[release-badge]: https://img.shields.io/github/v/release/jordanbaird/ColorWellKit?style=flat-square\n[versions-badge]: https://img.shields.io/badge/dynamic/json?color=F05138\u0026label=Swift\u0026query=%24.message\u0026url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2Fjordanbaird%2FColorWellKit%2Fbadge%3Ftype%3Dswift-versions\u0026style=flat-square\n[docs-badge]: https://img.shields.io/static/v1?label=%20\u0026message=documentation\u0026logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAADAAAAAwCAYAAABXAvmHAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAEsSURBVHgB7dntDYIwEAbgV+MAuoEj6AaO4AiO4AayAbqBbuAGjoIbwAbnHT8MMTH9uEJrvCch/FB7vEh7EABjjBMRnXhrKY1GxsNUuFhN45gmBKU783lCDKtBiYeoUoeYI79KE6KEACI6RCkBRFSIkgKI4BClBRBBIUoMILxDlBpASIgjtBL3gR2FaV1jzjyKvg98xqDEw615t3Z87eFbc/IAPkJqljwHvFiA3CxAbhaAdI+cNZTUfWD4edQBOMacog9cEE/z25514twsQG4/H2ABJZ5vG97tEefKc/QJhRR9oIH7AeWbjodchdYcSnEJLRGvg5L6EmJb3g6Ic4eSNbLcLEBuf9HIZKnrl0rtvX8E5zLr8w+o79kVbkiBT/yZxn3Z90lqVTDGOL0AoGWIIaQgyakAAAAASUVORK5CYII=\u0026color=informational\u0026labelColor=gray\u0026style=flat-square\n[license-badge]: https://img.shields.io/github/license/jordanbaird/ColorWellKit?style=flat-square\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjordanbaird%2Fcolorwellkit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjordanbaird%2Fcolorwellkit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjordanbaird%2Fcolorwellkit/lists"}