{"id":29562390,"url":"https://github.com/atomantic/hueknew","last_synced_at":"2025-09-24T16:52:26.533Z","repository":{"id":304373345,"uuid":"1012173638","full_name":"atomantic/HueKnew","owner":"atomantic","description":"mobile app game for teaching players the names of obscure colors","archived":false,"fork":false,"pushed_at":"2025-07-26T23:04:59.000Z","size":4783,"stargazers_count":2,"open_issues_count":4,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-07T01:31:46.729Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/atomantic.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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,"zenodo":null}},"created_at":"2025-07-01T23:56:06.000Z","updated_at":"2025-07-26T23:05:03.000Z","dependencies_parsed_at":"2025-07-27T01:08:25.534Z","dependency_job_id":"c9612057-2af5-4b98-a18c-3e1b25097cac","html_url":"https://github.com/atomantic/HueKnew","commit_stats":null,"previous_names":["atomantic/hueknew"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/atomantic/HueKnew","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atomantic%2FHueKnew","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atomantic%2FHueKnew/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atomantic%2FHueKnew/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atomantic%2FHueKnew/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/atomantic","download_url":"https://codeload.github.com/atomantic/HueKnew/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atomantic%2FHueKnew/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":276787035,"owners_count":25704726,"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","status":"online","status_checked_at":"2025-09-24T02:00:09.776Z","response_time":97,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":[],"created_at":"2025-07-18T17:37:10.903Z","updated_at":"2025-09-24T16:52:26.492Z","avatar_url":"https://github.com/atomantic.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# Hue Knew 🎨\n\n\u003c!-- START doctoc generated TOC please keep comment here to allow auto update --\u003e\n\u003c!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE --\u003e\n\n  - [🎯 Goal](#-goal)\n  - [📸 Screenshots](#-screenshots)\n  - [🎯 Game Overview](#-game-overview)\n    - [📚 Learning Phase](#-learning-phase)\n    - [🎮 Challenge Phase](#-challenge-phase)\n  - [🌟 Features](#-features)\n  - [🎨 Color Categories](#-color-categories)\n  - [🏆 Learning Objectives](#-learning-objectives)\n  - [🎮 How to Play](#-how-to-play)\n  - [🔮 Future Enhancements](#-future-enhancements)\n  - [📄 License](#-license)\n  - [🙏 Acknowledgments](#-acknowledgments)\n- [Development](#development)\n  - [🤝 Contributing](#-contributing)\n  - [🔧 Technical Details](#-technical-details)\n  - [📱 Requirements](#-requirements)\n  - [🚀 Getting Started](#-getting-started)\n\n\u003c!-- END doctoc generated TOC please keep comment here to allow auto update --\u003e\n\nThe ability for humans to observe and record memories of the world is limited by the language they have to describe it.\n\nHue Knew is an open-source SwiftUI color learning game that helps humans discover new colors, learn the subtle differences between similar colors, and learn their proper names.\n\n## 🎯 Goal\n\nAs a human, I want to be able to articulate the visual reality that humans experience with more accuracy. Rather than saying \"that person is wearing a yellow-orange shirt with brown-ish accent lines,\" if I know the names of more colors, I can say, \"that person is wearing a gamboge shirt with brown-sugar accent lines.\"\n\nI want to be able to recognize colors in the real world and connect them to more distinct language.\nI want to be able to hear a color name and visualize it in my mind.\n\n## 📸 Screenshots\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"Images/HueKnew_01.png\" width=\"200\" alt=\"Home Screen\"\u003e\n\u003cimg src=\"Images/HueKnew_02.png\" width=\"200\" alt=\"Learning\"\u003e\n\u003cimg src=\"Images/HueKnew_03.png\" width=\"200\" alt=\"Game\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"Images/HueKnew_04.png\" width=\"200\" alt=\"Lesson\"\u003e\n\u003cimg src=\"Images/HueKnew_05.png\" width=\"200\" alt=\"Catalog\"\u003e\n\u003cimg src=\"Images/HueKnew_06.png\" width=\"200\" alt=\"Details\"\u003e\n\u003c/p\u003e\n\n## 🎯 Game Overview\n\n**Hue Knew** is designed to train your eye to distinguish between similar colors that are often confused, such as:\n\n| Color Pair | Differences |\n|------------|-------------|\n| ![](https://placehold.co/16x16/E49B0F/E49B0F.png) **Gamboge** (#E49B0F) vs. ![](https://placehold.co/16x16/E3B505/E3B505.png) **Indian Yellow** (#E3B505) | • Gamboge is more orange and warmer\u003cbr\u003e• Indian Yellow is slightly brighter and more yellow\u003cbr\u003e• Gamboge has deeper, richer undertones |\n| ![](https://placehold.co/16x16/003153/003153.png) **Prussian Blue** (#003153) vs. ![](https://placehold.co/16x16/002147/002147.png) **Oxford Blue** (#002147) | • Prussian Blue is slightly more green-tinted\u003cbr\u003e• Oxford Blue has more purple undertones\u003cbr\u003e• Prussian Blue is marginally lighter |\n| ![](https://placehold.co/16x16/DC143C/DC143C.png) **Crimson** (#DC143C) vs. ![](https://placehold.co/16x16/B22222/B22222.png) **Firebrick** (#B22222) | • Crimson is brighter and more vibrant\u003cbr\u003e• Firebrick is darker and more muted\u003cbr\u003e• Crimson has a slight blue undertone |\n| ![](https://placehold.co/16x16/6A0DAD/6A0DAD.png) **Purple** (#6A0DAD) vs. ![](https://placehold.co/16x16/702670/702670.png) **Midnight** (#702670) | • Purple is more saturated and vibrant\u003cbr\u003e• Midnight is darker and more mysterious\u003cbr\u003e• Purple has more blue undertones |\n| ![](https://placehold.co/16x16/CC5500/CC5500.png) **Burnt Orange** (#CC5500) vs. ![](https://placehold.co/16x16/D2691E/D2691E.png) **Chocolate** (#D2691E) | • Burnt Orange is more orange and vibrant\u003cbr\u003e• Chocolate is more brown and muted\u003cbr\u003e• Burnt Orange is brighter and warmer |\n| ![](https://placehold.co/16x16/FFFF00/FFFF00.png) **Yellow** (#FFFF00) vs. ![](https://placehold.co/16x16/FFF700/FFF700.png) **Lemon** (#FFF700) | • Yellow is pure and more saturated\u003cbr\u003e• Lemon is slightly more green-tinted\u003cbr\u003e• Yellow is brighter and more electric |\n| ![](https://placehold.co/16x16/228B22/228B22.png) **Forest Green** (#228B22) vs. ![](https://placehold.co/16x16/355E3B/355E3B.png) **Hunter Green** (#355E3B) | • Forest Green is brighter and more vibrant\u003cbr\u003e• Hunter Green is darker and more muted\u003cbr\u003e• Forest Green has more yellow undertones |\n| ![](https://placehold.co/16x16/696969/696969.png) **Dim Gray** (#696969) vs. ![](https://placehold.co/16x16/555555/555555.png) **Davy's Grey** (#555555) | • Dim Gray is lighter and more neutral\u003cbr\u003e• Davy's Grey is darker and more saturated\u003cbr\u003e• Dim Gray has a cooler undertone |\n\nThe game uses a progressive learning approach with two main phases:\n\n### 📚 Learning Phase\n- **Side-by-side comparison**: View two similar colors together with their names\n- **Study the differences**: Learn the subtle variations that distinguish each color\n- **Take your time**: No pressure - focus on understanding the nuances\n\n### 🎮 Challenge Phase\n- **Name-to-color matching**: Given a color name, select the correct hue\n- **Color-to-name matching**: Given a color, choose the correct name\n- **Multiple choice format**: Pick from carefully selected similar options\n- **Immediate feedback**: Learn from mistakes with explanations\n\n## 🌟 Features\n\n- **Progressive difficulty**: Start with obvious differences, advance to subtle variations\n- **Smart color pairs**: Curated color combinations that are commonly confused\n- **Achievement system**: Track your progress and unlock new color categories\n- **Streak tracking**: Monitor your learning momentum\n- **Color vision test**: Optional accessibility test to adapt challenges\n- **Category-based learning**: Focus on specific color families (blues, yellows, reds, etc.)\n- **Imagine environments**: Brainstorm colors for scenes like forests or deserts\n- **Autocomplete suggestions**: Get prompted with likely colors for each environment\n\n## 🎨 Color Categories\n\n- **Yellows**: Gamboge, Indian Yellow, Cadmium Yellow, Lemon Yellow, Saffron, Goldenrod\n- **Blues**: Prussian Blue, Navy, Cerulean, Glaucous, Ultramarine, Cobalt Blue\n- **Reds**: Crimson, Firebrick, Vermillion, Carmine, Burgundy, Venetian Red\n- **Greens**: Forest Green, Hunter Green, Viridian, Malachite, Sage, Emerald\n- **Purples**: Purple, Midnight, Royal Purple, Lavender, Amethyst, Byzantium\n- **Oranges**: Burnt Orange, Chocolate, Cadmium Orange, Tangerine, Marigold, Persimmon\n- **Neutrals**: Dim Gray, Davy's Grey, Silver, Platinum, Ivory, Charcoal\n\n## 🏆 Learning Objectives\n\n- **Develop color vocabulary**: Learn proper names for specific hues\n- **Train visual discrimination**: Improve ability to spot subtle differences\n- **Build confidence**: Reduce uncertainty when describing colors\n- **Practical application**: Use knowledge in art, design, and daily life\n\n## 🎮 How to Play\n\n1. **Start with Learning Mode**: Choose a color category to study\n2. **Compare colors**: Study two similar colors side-by-side\n3. **Read the differences**: Learn what makes each color unique\n4. **Take the challenge**: Test your knowledge with randomized questions\n5. **Track progress**: Build streaks and unlock new categories\n\n\n## 🔮 Future Enhancements\n\n- **Custom color sets**: Import your own color palettes\n- **Timed challenges**: Speed rounds for advanced users\n- **Color blindness support**: Accommodations for different vision types\n- **Social features**: Share progress and compete with friends\n- **Advanced analytics**: Detailed learning progress tracking\n\n## 📄 License\n\nThis project is licensed under the HueKnew License - see the [LICENSE.md](LICENSE.md) file for details.\n\n## 🙏 Acknowledgments\n\n- Color definitions sourced primarily from the Wikipedia pages but curated and tailored with aggregate LLM knowledge:\n - https://en.wikipedia.org/wiki/List_of_colors:_A%E2%80%93F\n - https://en.wikipedia.org/wiki/List_of_colors:_G%E2%80%93M\n - https://en.wikipedia.org/wiki/List_of_colors:_N%E2%80%93Z\n- Thanks to [Placehold.co](https://placehold.co/) for the color swatch previews in this file and other places :)\n\n\n# Development\n\n## 🤝 Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request or simply file an issue and we will get to work on it!\n\n## 🔧 Technical Details\n\n- **Platform**: iOS 18.2+\n- **Framework**: SwiftUI\n- **Architecture**: MVVM with @Observable\n- **Language**: Swift 5.9\n\n## 📱 Requirements\n\n- iOS 18.2 or later\n- Xcode 16.0 or later\n- Swift 5.9 or later\n\n## 🚀 Getting Started\n\n1. Clone the repository:\n   ```bash\n   git clone https://github.com/atomantic/HueKnew.git\n   cd HueKnew\n   ```\n\n2. Open the project in Xcode:\n   ```bash\n   open \"HueKnew.xcodeproj\"\n   ```\n\n3. Build and run the project on a simulator or device\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fatomantic%2Fhueknew","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fatomantic%2Fhueknew","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fatomantic%2Fhueknew/lists"}