Skip to content

🎨 docs: Document the Remaining Theme Appearance Keys - #813

Merged
berry-13 merged 3 commits into
mainfrom
berry-13/theme-appearance-keys
Oct 8, 2026
Merged

berry-13 merged 3 commits into
mainfrom
berry-13/theme-appearance-keys

Conversation

@berry-13

@berry-13 berry-13 commented Oct 8, 2026 •

Copy link
Copy Markdown
Collaborator

Summary

The theme page documented 73 of LibreChat's 103 appearance keys. This adds the other 30 to the Appearance table with what each controls, its default and the role it follows when unset: the popover, menu panel and composer action radii, tooltip padding and text size, tab and Select list sizes, Button padding and the xs, lg, compact and icon-sm sizes, the large field height, icon and checkbox sizes, the 10, 11, 13, 15 and 30px type steps with the text-3xl leading, inline code weight, the neutral button border opacity, the chrome and inset border alphas, and destructiveStyle. The accepted values list now covers their bounds (pointer targets at least 24px, icon, checkbox and list height ranges, the fill/soft choice).

The ClickHouse section is brought up to date with LibreChat-AI/LibreChat#16821: palette values are Click UI's own even where a pairing falls below WCAG AA (high-contrast modes remain available), and it now describes the hidden decorative borders and soft destructive style. The page also stops saying it describes LibreChat's canary branch: these keys and the Click UI palette are on dev only, so the opening note is the site's "Pending: not yet released" callout and the source links point at dev (the same change as #814, so the two merge cleanly in either order).

Change Type

  • Documentation

Testing

  • Every key in themeAppearanceProperties (packages/client/src/theme/registry.ts on LibreChat dev) has a row in the table: checked with a script over the registry.
  • Defaults and accepted values read from defaultAppearance and appearanceValidators (packages/data-provider/src/theme.ts).
  • prettier --check on the page: clean.

Checklist

  • Defaults and validation match the current LibreChat dev

@vercel

vercel Bot commented Oct 8, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
librechat-ai Ready Ready Preview Oct 8, 2026 8:57pm UTC

Request Review

@berry-13
berry-13 marked this pull request as ready for review October 8, 2026 20:30
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 8, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-10-08T20:53:39.133788Z b3e6d03 New commits
🔒 Security Review ✅ Completed 2026-10-08T20:32:49.820577Z 99013cc Draft marked ready
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@chatgpt-codex-connector chatgpt-codex-connector 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.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 99013cc416

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

`interface.theme: clickhouse` changes both color and shape:

- **Palette.** Every color token is defined in both modes from Click UI's light and dark tokens, so nothing falls back to the LibreChat palette. A few values are moved along their Click UI ramps where the verbatim value missed WCAG AA contrast.
- **Palette.** Every color token is defined in both modes from Click UI's light and dark tokens, so nothing falls back to the LibreChat palette. Values are Click UI's own, even where a pairing falls below WCAG AA contrast. Users who need more contrast can pick a high-contrast mode, which always uses the built-in accessible palette (see [How the theme is chosen](#how-the-theme-is-chosen)).

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P1 Badge Wait for these changes to reach the documented canary branch

The page says it describes LibreChat's canary branch, but the checked canary sources still contain the contrast-adjusted ClickHouse palette and none of the newly documented appearance tokens (for example, menuPanelRadius, buttonHeightXs, or chromeBorderAlpha); these changes currently exist only in pending/dev work. Consequently, canary operators are told the opposite palette behavior and any configurations using the new rows are silently logged and ignored. Merge the corresponding LibreChat changes into canary first, or clearly mark this entire update as dev-only.

Useful? React with 👍 / 👎.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

Fixed in b3e6d03: the page no longer claims canary; it opens with the Pending: not yet released callout saying these keys are on dev only (v0.8.8 does not read interface.theme), and the source links point at dev.

@github-actions

github-actions Bot commented Oct 8, 2026

Copy link
Copy Markdown
Contributor

📦 Next.js Bundle Analysis for librechat.ai

This analysis was generated by the Next.js Bundle Analysis action. 🤖

This PR introduced no changes to the JavaScript bundle! 🙌

@github-actions

github-actions Bot commented Oct 8, 2026

Copy link
Copy Markdown
Contributor

📦 Next.js Bundle Analysis for librechat.ai

This analysis was generated by the Next.js Bundle Analysis action. 🤖

This PR introduced no changes to the JavaScript bundle! 🙌

@berry-13
berry-13 merged commit 9fdcbff into main Oct 8, 2026
5 checks passed
@berry-13
berry-13 deleted the berry-13/theme-appearance-keys branch October 8, 2026 20:58

This branch was successfully deployed

1 active deployment
Preview — b3e6d03f Deployed Oct 8, 2026 by vercel[bot]
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.

1 participant