Skip to content

fix(desktop): use dark text on accent button for readable contrast - #31

Merged
Miyamura80 merged 1 commit into
mainfrom
claude/desktop-contrast-issue-r21wjw
Aug 6, 2026
Merged

fix(desktop): use dark text on accent button for readable contrast#31
Miyamura80 merged 1 commit into
mainfrom
claude/desktop-contrast-issue-r21wjw

Conversation

@Miyamura80

@Miyamura80 Miyamura80 commented Aug 6, 2026

Copy link
Copy Markdown
Contributor

Summary

  • The sign-in button on the welcome screen used text-white on the bright cyan --accent (#7dfff6), giving a contrast ratio of ~1.2:1 (WCAG minimum is 4.5:1) — the text was nearly invisible
  • Changed to text-[var(--bg-base)] (dark text) to match the shared Button component's primary variant
  • Also bumped the explanatory text below the button from --text-muted to --text-secondary for better readability

Test plan

  • Verify the "Sign in with your browser" button text is clearly readable (dark on cyan) in the desktop app's welcome screen
  • Verify the explanatory text below the button is legible
  • Confirm Storybook Client2/WelcomeStep stories render correctly

https://claude.ai/code/session_01ShEgHD4LY9DCJgXvnNaasE


Generated by Claude Code


Summary by cubic

Fix unreadable sign-in button text on the desktop welcome screen by switching to dark text (text-[var(--bg-base)]) on the bright cyan --accent background to meet WCAG contrast guidelines. Also updates the helper text below the button from --text-muted to --text-secondary for better readability.

Written for commit 084a96c. Summary will update on new commits.

Review in cubic

The sign-in button used text-white on the bright cyan --accent (#7dfff6),
giving a ~1.2:1 contrast ratio. Switch to text-[var(--bg-base)] to match
the shared Button primary variant. Also bump the explanatory text from
--text-muted to --text-secondary for better readability.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01ShEgHD4LY9DCJgXvnNaasE
@qodo-code-review

Copy link
Copy Markdown

PR Summary by Qodo

Fix welcome screen button contrast by using dark text on accent background

🐞 Bug fix 🕐 Less than 5 minutes

Grey Divider

AI Description

• Switch the welcome screen sign-in button text to dark for WCAG-readable contrast.
• Increase the explanatory caption color from muted to secondary for improved legibility.
Diagram

graph TD
  A["WelcomeStep (desktop)"] --> B["Sign-in button styles"] --> C["auth.signInWithBrowser()"]
  A --> D["Caption text styles"]
  B --> E["Theme CSS vars"]
  D --> E
Loading
High-Level Assessment

The following are alternative approaches to this PR:

1. Use shared primary variant
  • ➕ Avoids bespoke styling drift between onboarding and shared button patterns
  • ➕ Centralizes accessible contrast decisions in one component/theme mapping
  • ➖ May require small refactor of markup/layout (icon spacing, full-width behavior)
  • ➖ Potentially more review surface than a targeted classname fix
2. Introduce a dedicated on-accent text token (e.g., --text-on-accent)
  • ➕ Makes contrast intent explicit and reusable across the app
  • ➕ Reduces coupling to --bg-base semantics for text color
  • ➖ Requires design/token work and wider theme changes
  • ➖ Overkill for a single isolated instance

Recommendation: The PR’s targeted switch to a dark text color is a good, low-risk fix for the immediate contrast problem. If this screen is expected to remain long-term, consider a follow-up to use the shared Button primary variant (or introduce a --text-on-accent token) to prevent future divergence and keep contrast guarantees centralized.

Files changed (1) +2 / -2

Bug fix (1) +2 / -2
WelcomeStep.tsxFix sign-in button and caption colors for better contrast +2/-2

Fix sign-in button and caption colors for better contrast

• Updates the sign-in button text color from white to a dark theme color to improve readability on the accent background. Also adjusts the explanatory caption color from muted to secondary for better legibility.

packages/desktop/src/renderer/src/components/onboarding/WelcomeStep.tsx

@qodo-code-review

Copy link
Copy Markdown

Code Review by Qodo

🐞 Bugs (0) 📘 Rule violations (0) 📎 Requirement gaps (0)

Grey Divider

Great, no issues found!

Qodo reviewed your code and found no material issues that require review

Grey Divider

To customize comments, go to the Qodo configuration screen, or learn more in the docs.

Qodo Logo

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No issues found across 1 file

Re-trigger cubic

@Miyamura80
Miyamura80 merged commit e94415b into main Aug 6, 2026
8 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants