[BUG]: Fix Team Builder Secondary Text Contrast Across Themes

Open Beginner friendly
#521 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
72/100
Issue type
Bug
Clarity
Mostly clear
Activity status
Active
Tech stack
typescript

Research direction

Start at the Team Debate section and locate the Team Builder component and its theme-specific text styles. Reproduce the subtitle and helper text in light, dark, and high contrast themes, then align their colors with the existing design system while preserving the light theme; verify that both texts remain readable in all supported themes.

Written by the indexing model from the issue text.

Description

bug
Bug Description

On the Team Debate section, the Team Builder component contains supporting text such as “Create or join a team to participate in team debates” below the main heading and “Teams match only with teams of the same size!” below the team size options.

The light theme displays these texts with appropriate contrast and readability. However, in the dark and high contrast themes, these secondary texts appear too muted and low-contrast against the background.

The main issues observed are:

The Team Builder subtitle appears significantly faded in the dark and high contrast themes, making it harder to read.

The “Teams match only with teams of the same size!” helper text also uses a muted color that does not provide sufficient contrast with the dark background.

The text styling does not appear to properly adapt to the active theme, unlike the main headings and other UI elements.

Steps to Reproduce

Sign in to DebateAI.
Navigate to the main page.
Open the Team Debate section.
Locate the Team Builder section.
Observe the subtitle “Create or join a team to participate in team debates”.
Scroll within the Team Builder section and observe “Teams match only with teams of the same size!”.
Switch between the light, dark, and high contrast themes.
Compare the readability and contrast of these secondary texts.

Expected Behavior

The Team Builder secondary text should adapt appropriately to each supported theme.
In the light theme, the current appearance should be preserved.
In the dark theme, the subtitle and helper text should use a suitable light/muted color with enough contrast against the dark background.
In the high contrast theme, these texts should follow the high contrast color system and remain clearly visible and readable.
Theme-specific text colors should be consistent with the application's existing design system rather than relying on a fixed or overly muted color.

Actual Behavior

The Team Builder subtitle and “Teams match only with teams of the same size!” helper text appear too dim in the dark and high contrast themes.
Because of the low contrast, these texts are less readable and visually inconsistent with the rest of the interface.
The light theme does not exhibit this issue.

Logs and Screenshots

https://github.com/user-attachments/assets/027a437f-b153-4bea-8182-878bd6430eb6

Environment Details

No response

Impact

Medium - Feature works but has issues

Code of Conduct
  • I have joined the Discord server and will post updates there
  • I have searched existing issues to avoid duplicates
Dominant language
TypeScript
Stars
88
Forks
207
Avg merge
2d 12h
Merged PRs (30d)
29

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from AOSSIE-Org/DebateAI

All issues in AOSSIE-Org/DebateAI

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.