{"id":13760592,"url":"https://github.com/bernaferrari/color-studio","last_synced_at":"2025-04-29T19:56:35.540Z","repository":{"id":48458707,"uuid":"230337410","full_name":"bernaferrari/color-studio","owner":"bernaferrari","description":"It is too hard to build coherent and accessible themes with the right colors. This should help.","archived":false,"fork":false,"pushed_at":"2023-03-15T02:52:32.000Z","size":6975,"stargazers_count":429,"open_issues_count":3,"forks_count":23,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-04-29T19:56:29.141Z","etag":null,"topics":["color-picker","dark-theme","flutter","hsl","hsluv","hsv","material-design","rgb","themes"],"latest_commit_sha":null,"homepage":"","language":"Dart","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bernaferrari.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}},"created_at":"2019-12-26T22:46:19.000Z","updated_at":"2025-04-05T05:38:34.000Z","dependencies_parsed_at":"2024-01-18T19:11:41.049Z","dependency_job_id":null,"html_url":"https://github.com/bernaferrari/color-studio","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bernaferrari%2Fcolor-studio","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bernaferrari%2Fcolor-studio/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bernaferrari%2Fcolor-studio/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bernaferrari%2Fcolor-studio/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bernaferrari","download_url":"https://codeload.github.com/bernaferrari/color-studio/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251574671,"owners_count":21611387,"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":["color-picker","dark-theme","flutter","hsl","hsluv","hsv","material-design","rgb","themes"],"created_at":"2024-08-03T13:01:13.642Z","updated_at":"2025-04-29T19:56:35.517Z","avatar_url":"https://github.com/bernaferrari.png","language":"Dart","funding_links":[],"categories":["Dart","Uncategorized"],"sub_categories":["Uncategorized"],"readme":"![Image of Color Studio](assets/header.png)\n\n# Color Studio\n\nIt is hard to choose colors. Most color pickers give you 16 million colors and ask you to pick one. So many options, in\nfact, that your creativity may get blocked. There is no intuitive way to know which colors will fit your needs. This\ngets even harder when you deal with multiple colors. Even harder when you want these colors to follow a design\nspecification and form a coherent theme. This project aims to help solve these problems.\n\n\u003ca href=\"https://bernaferrari.github.io/color-studio\"\u003e\u003cimg src=\"assets/try_web.png\" height=\"70\"/\u003e\u003c/a\u003e \u003ca href=\"https://github.com/bernaferrari/color-studio/releases\"\u003e\u003cimg src=\"assets/try_macOS.png\" height=\"70\"/\u003e\u003c/a\u003e\n\n[\u003cimg src=\"https://play.google.com/intl/en_us/badges/images/generic/en-play-badge.png\" alt=\"Get it on Google Play\" height=\"80\"\u003e](https://play.google.com/store/apps/details?id=com.bernaferrari.colorstudio)\n\n| Main | Single Selector |\n|:-:|:-:|\n| ![First](assets/web_0.png?raw=true) | ![Sec](assets/web_1.png?raw=true) |\n\n### History\n\nFirst and foremost, but not exclusively, this app follows Material Design, with a special emphasis in dark mode. While\ndark mode is trending nowadays, the idea came when\nwriting [Change Detection](https://github.com/bernaferrari/ChangeDetection). Back then it was hard to make a coherent\ndark theme. In [May 2019](https://github.com/material-components/material-components-android/releases/tag/1.1.0-alpha06)\n, Material Design Components for Android started receiving dark mode support. Material Dark Theme,\nhowever, [has a twist](https://material.io/design/color/dark-theme.html#properties): it applies a white overlay as a\nsurface gets higher (more elevated). Back then, as far as I remember, this was mandatory (now it is optional) and\ninstantly broke half my app. I started using more and more `elevation = 0`, but then it made the light theme worse.\nChoosing colors, which was already hard, became trial and error. I relied a lot\non [Color Hexa](https://www.colorhexa.com/), but as my projects got more complex, it got insufficient and became a pain.\nSuddenly, I was already developing my own tool.\n\n### Overview\n\n#### Color Scheme\n\nThis app allows you to play with 3 colors: Primary, Background and Surface. Background and Surface allows you to\ntoggle \"auto\" mode. In auto mode, Background follows\nthe [Material Design recommendation](https://material.io/design/color/dark-theme.html#properties): 8% of Primary color +\n#121212. Regarding Surface color, there is no official recommendation. Initially, the app made it the same as the\nBackground color, but this didn't feel good. Inspired\nby [Moleskine Timepage](https://apps.apple.com/us/app/timepage/id989178902), Surface now gets the Background and adds 5%\nof lightness in [HSLuv](http://www.hsluv.org/) color space. If Background has 10% of lightness, Surface has 15%.\n\nEverything was written with extensibility in mind. The colors are not hard-coded, and it is straight-forward to add more\nor modify them in the future. In a previous app version, Secondary color was also present, but was removed to make the\napp simpler.\n\n\u003cp align=\"center\"\u003e\u003cimg src=\"assets/color_scheme.jpg?raw=true\" alt=\"Color Scheme\" height=\"350px\"\u003e\u003c/p\u003e\n\n#### Contrast\n\nWeb Content Accessibility Guidelines (WCAG) recommends a contrast of:\n\n- **3.0:1** minimum for texts larger than 18pt or icons (AA+).\n- **4.5:1** minimum for texts smaller than 18pt (AA).\n- **7.0:1** minimum when possible, if possible (AAA).\n\nIf you want to know more about contrast, read [this](https://usecontrast.com/guide)\n, [this](https://www.w3.org/TR/WCAG21/#contrast-minimum)\nor [this](https://www.carbondesignsystem.com/guidelines/accessibility/color/).\n\n#### Color Blindness\n\n\u003e Don’t rely on color alone to convey meaning. This includes conveying information, indicating an action, prompting the user for a response, or distinguishing one visual element from another.\n\u003e\n\u003e Source: [Carbon Design System](https://www.carbondesignsystem.com/guidelines/accessibility/color/)\n\n\u003e Because colorblindness takes different forms (including red-green, blue-yellow, and monochromatic), multiple visual cues help communicate important states. Elements such as strokes, indicators, patterns, texture, or text can describe actions and content.\n\u003e\n\u003e Source: [Material Design System](https://material.io/design/usability/accessibility.html#color-contrast)\n\nThis project allows you to select between 8 different Color Blindness scenarios using the formulas from a Swift library\nnamed [Colorblinds](https://github.com/jdekock/Colorblinds). It automatically updates the contrast ratio between colors,\nso that you can see simulate a color blind scenario.\n\n## Reporting Issues\n\nIt is not easy to develop alone. I am a developer, not a designer. If you have any design suggestions, feature requests\nor would like to integrate your own color specs, issues and pull requests are welcome. You can\nreport [here](https://github.com/bernaferrari/color-studio/issues).\n\n## License\n\n    Copyright 2021 Bernardo Ferrari\n\n    Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:\n\n    The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.\n\n    THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbernaferrari%2Fcolor-studio","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbernaferrari%2Fcolor-studio","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbernaferrari%2Fcolor-studio/lists"}