BlindByte98 / BlindByte98/Colorblind-Assistant

Help Wanted: Expand Color List for Colorblind Accessibility

Open
#1 0 comments 0 reactions 0 assignees View on GitHub
enhancement good first issue help wanted
Dominant language
Python
Stars
2
Forks
1
PR merge metrics
No merged PRs in 30d

Description

# Help Wanted: Expand Color List for Colorblind Accessibility

---

## Preview
![Color Picker Preview](https://github.com/user-attachments/assets/7724f8c5-2af9-424c-890a-053514000150)

---

## Description
Our repository includes two files:

- **`main.py`**: Logic for determining and displaying the current color under the cursor.
- **`colors.py`**: A list of colors, each with:
- A human‑readable name
- A hex code
- A broad category (e.g., “blue”, “red”, “green”)

These categories help users with color vision deficiencies understand what color they’re seeing. The current list is limited, which can lead to ambiguous or inaccurate results.

---

## Objective
Enhance **`colors.py`** so that:

1. **Any Contribution Counts**
- Even one new color, a corrected hex code, or a fixed duplicate is a huge win.
2. **Comprehensive Coverage**
- Cover as many distinct hues and shades as possible.
3. **Clear Categories**
- Ensure every entry has the most appropriate broad category for reliable mapping.
4. **Accessibility**
- Help users with colorblindness identify hovered colors by providing meaningful category labels.

---

## Tasks
1. **Audit & Fix**
- Correct typos, remove duplicates, and fix any hex‑to‑name mismatches.
2. **Add New Colors**
- Research standard web‑safe and extended palettes; add at least a few new entries (one is fine!).
3. **Refine Categories**
- Map each hex to one of: red, orange, yellow, green, blue, purple, brown, gray, pink.
4. **Verify with `main.py`**
- Run `main.py` to confirm each sample color reports the expected category.

---

## How to Contribute
1. Fork the repo and create a branch (e.g., `feature/expand-colors`).
2. Update **`colors.py`**:
- Add new entries, fix duplicates, correct categories—any change helps.
3. Run `python main.py` to ensure no errors and verify outputs.
4. Submit a PR with your changes and a brief note on what you added or fixed.

---

## Acceptance Criteria
- No typos or duplicate entries remain.
- At least some new colors added (even one!).
- Categories are accurate and consistent.
- `main.py` outputs correct categories for your test colors.
- PR includes a note on your contributions (data sources or methodology optional).

Thank you—every addition, big or small, makes a difference for users with color vision differences!

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.