Skip to content

Rework light theme readability and contrast #79

Description

@cyfyifanchen

Summary

The Raven TUI light theme needs a visual pass. In the current light theme, the start screen looks washed out and several UI elements have poor contrast against a white terminal background.

Observed issues

  • The large RAVEN AGENT banner is too pale on a light background and becomes hard to read.
  • The raven logo / ASCII art uses low-contrast olive tones that blur into the page.
  • Headings, metadata, and separators do not have a strong enough hierarchy in light mode.
  • The bordered welcome panel feels visually heavy while the content inside feels faint.
  • The light theme needs to be checked across the TUI, not only the welcome screen.

Suggested scope

  • Define a dedicated light-theme palette instead of relying on dark-theme colors on a light background.
  • Improve contrast for banner text, ASCII art, headings, muted text, borders, command hints, and status metadata.
  • Review key TUI surfaces: welcome screen, chat transcript, input area, tool/skill lists, status bars, dialogs, and error/warning states.
  • Keep dark theme behavior unchanged.

Acceptance criteria

  • Light theme text and important UI states are readable on a white or near-white terminal background.
  • The welcome screen has clear visual hierarchy without looking washed out.
  • Borders and separators are visible but not overpowering.
  • The theme is verified manually in a light terminal profile, with before/after screenshots added to the PR.

Activity

  1. added
    enhancementNew feature or request
    and removed
    enhancementNew feature or request
    on Jul 7, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions