{"id":15055353,"url":"https://github.com/jordanbaird/colorwell","last_synced_at":"2025-10-21T10:42:47.853Z","repository":{"id":63913625,"uuid":"549334959","full_name":"jordanbaird/ColorWell","owner":"jordanbaird","description":"A versatile alternative to NSColorWell for Cocoa and ColorPicker for SwiftUI.","archived":true,"fork":false,"pushed_at":"2023-10-07T21:21:25.000Z","size":2895,"stargazers_count":20,"open_issues_count":0,"forks_count":3,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-12-30T22:41:39.893Z","etag":null,"topics":["apple","color","color-picker","color-well","colorpicker","colorwell","macos","nscolorwell","swift","swift-package-manager","swiftui"],"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}},"created_at":"2022-10-11T03:03:17.000Z","updated_at":"2024-04-27T22:55:16.000Z","dependencies_parsed_at":"2023-01-14T13:30:34.435Z","dependency_job_id":null,"html_url":"https://github.com/jordanbaird/ColorWell","commit_stats":{"total_commits":217,"total_committers":1,"mean_commits":217.0,"dds":0.0,"last_synced_commit":"2c6baeda3ae3aeeb01b52597ac7cab5f2390906f"},"previous_names":[],"tags_count":16,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jordanbaird%2FColorWell","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jordanbaird%2FColorWell/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jordanbaird%2FColorWell/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jordanbaird%2FColorWell/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jordanbaird","download_url":"https://codeload.github.com/jordanbaird/ColorWell/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":235265001,"owners_count":18962467,"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","color","color-picker","color-well","colorpicker","colorwell","macos","nscolorwell","swift","swift-package-manager","swiftui"],"created_at":"2024-09-24T21:41:13.345Z","updated_at":"2025-10-04T15:30:20.237Z","avatar_url":"https://github.com/jordanbaird.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"## Notice\n\nDue to a number of design problems and increasing repository bloat, this package has been deprecated and replaced, and this repository will be archived. Please use its successor [ColorWellKit](https://github.com/jordanbaird/ColorWellKit) instead.\n\n# ColorWell\n\n[![Continuous Integration][ci-badge]](https://github.com/jordanbaird/ColorWell/actions/workflows/test.yml)\n[![Release][release-badge]](https://github.com/jordanbaird/ColorWell/releases/latest)\n[![Swift Versions][versions-badge]](https://swiftpackageindex.com/jordanbaird/ColorWell)\n[![Docs][docs-badge]](https://swiftpackageindex.com/jordanbaird/ColorWell/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/ColorWell/Documentation.docc/Resources/color-well-with-popover-dark.png\", style=\"width:37%\"\u003e\n    \u003cimg src=\"Sources/ColorWell/Documentation.docc/Resources/color-well-with-popover-light.png\", style=\"width:37%\"\u003e\n\u003c/div\u003e\n\nColorWell is designed to mimic the appearance and behavior of the new color well design in macOS 13 Ventura, for those who want to use the new design on older operating systems. While the goal is for ColorWell to look and behave in a similar way to Apple's design, it is not 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. However, in practice, there are very few notable differences:\n\n\u003cdiv align=\"center\"\u003e\n    \u003cpicture\u003e\n        \u003csource media=\"(prefers-color-scheme: dark)\" width=\"75%\" srcset=\"Sources/ColorWell/Documentation.docc/Resources/design-comparison-dark.png\"\u003e\n        \u003csource media=\"(prefers-color-scheme: light)\" width=\"75%\" srcset=\"Sources/ColorWell/Documentation.docc/Resources/design-comparison-light.png\"\u003e\n        \u003cimg src=\"Sources/ColorWell/Documentation.docc/Resources/design-comparison-light.png\" width=\"75%\"\u003e\n    \u003c/picture\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/ColorWell\", from: \"0.2.2\")\n```\n\n## Usage\n\n[Read the full documentation here](https://swiftpackageindex.com/jordanbaird/ColorWell/documentation)\n\n### SwiftUI\n\nCreate a `ColorWellView` and add it to your view hierarchy. There are a wide range of initializers, as well as several modifiers to choose from, allowing you to set the color well's color, label, and action.\n\n```swift\nimport SwiftUI\nimport ColorWell\n\nstruct ContentView: View {\n    @Binding var fontColor: Color\n\n    var body: some View {\n        VStack {\n            ColorWellView(\"Font Color\", color: fontColor, action: updateFontColor)\n                .colorWellStyle(.expanded)\n\n            MyCustomTextEditor(fontColor: $fontColor)\n        }\n    }\n\n    private func updateFontColor(_ color: Color) {\n        fontColor = color\n    }\n}\n```\n\n### Cocoa\n\nCreate a `ColorWell` using one of the available initializers. Observe color changes using the `onColorChange(perform:)` method.\n\n```swift\nimport Cocoa\nimport ColorWell\n\nclass ContentViewController: NSViewController {\n    let colorWell: ColorWell\n    let textEditor: MyCustomNSTextEditor\n\n    init(fontColor: NSColor) {\n        self.colorWell = ColorWell(color: fontColor)\n        self.textEditor = MyCustomNSTextEditor(fontColor: fontColor)\n\n        super.init(nibName: \"ContentView\", bundle: Bundle(for: Self.self))\n\n        // Set the style\n        colorWell.style = .expanded\n\n        // Add a change handler\n        colorWell.onColorChange { newColor in\n            self.textEditor.fontColor = newColor\n        }\n    }\n\n    override func viewDidLoad() {\n        super.viewDidLoad()\n\n        view.addSubview(colorWell)\n        view.addSubview(textEditor)\n\n        // Layout the views, perform setup work, etc.\n    }\n}\n```\n\n## License\n\nColorWell is available under the [MIT license](LICENSE).\n\n[ci-badge]: https://img.shields.io/github/actions/workflow/status/jordanbaird/ColorWell/test.yml?branch=main\u0026style=flat-square\n[release-badge]: https://img.shields.io/github/v/release/jordanbaird/ColorWell?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%2FColorWell%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/ColorWell?style=flat-square\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjordanbaird%2Fcolorwell","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjordanbaird%2Fcolorwell","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjordanbaird%2Fcolorwell/lists"}