Skip to content

docs: say accent-colored text is lightened to stay readable - #448

Draft
Quick104 wants to merge 2 commits into
mainfrom
docs/accent-text-readable
Draft

Quick104 wants to merge 2 commits into
mainfrom
docs/accent-text-readable

Conversation

@Quick104

@Quick104 Quick104 commented Nov 21, 2026 •

Copy link
Copy Markdown
Contributor

Problem

Closes #447

Blocked by Silo-Server/silo-server#4780, which isn't merged yet. This pull request stays a draft until it is.

With #4780, the web app draws text in the accent color (links, the current page in the admin and settings sidebars) in a lighter shade when the chosen color wouldn't be readable on the dark theme. An admin who picks a dark accent such as indigo would see lighter text than the color they chose, and the branding page doesn't explain why.

Pages changed

Page Change Preview
Customize your server's appearance Accent color step explains lighter accent text; readability advice names what's left to check Open

What changed on each page

Customize your server's appearance

  • Step 2 adds: "Text in the accent color, such as links and the current page in the admin and settings sidebars, may use a lighter shade so it stays readable on the dark background. Buttons and the bar beside the current page keep your exact color. For people who choose High Contrast under Settings > Accessibility, accent text can be lighter still."
  • The readability advice now reads: "check that your logos stand out and the sign-in page stays readable over your login background." It previously asked admins to keep text and controls readable against their colors.
  • Added to questions: "Why is text lighter than the accent color I picked?"

Worth checking: the step doesn't say that focus outlines turn white with High Contrast. That behavior was already there before #4780, and the step no longer says outlines keep the exact color.

Left out on purpose

  • The 4.5:1 target and how the lighter shade is calculated. No other page goes to that depth.
  • The stale Advanced changes section on the same page. The issue lists it as out of scope; it needs its own change.

Evidence

Source reviewed, not tested on a live server or device:
silo-server#4780 head ca9c6bfa453a8f81e8926bc4268f86c44cb73e5a (unmerged), siloserver.org d3b0482.

Needs a hands-on check: Nothing.

bun run test:docs: tests 8, pass 8, fail 0
bun run build: passed
Search: 154 of 164 queries find an expected page in the top 3.
git diff --check: clean

Evidence: https://evidence.siloserver.org/r/siloserver-org/accent-text-readable/

Risks

None identified. Documentation only.

Checklist

  • I read and can explain the complete diff.
  • This pull request addresses one concern.

AI Disclosure

  • Harness: Claude Code in T3 Code
  • Tool(s): silo-docs skill, humanizer skill, gh, bun
  • Model(s): claude-opus-5-5
  • Involvement: Fully AI-generated, human verification pending in review
  • Adversarial review: Sol (gpt-6.2-sol), Opus (claude-opus-5-5), Gemini (gemini-4-neon), medium effort, 1 round(s), 12 of 12 findings applied (one in part)

🤖 Generated with Claude Code

Note

Document that accent-colored text is lightened for readability

Expands the branding guide in branding.md with an FAQ explaining that accent-colored text may use a lighter shade, while buttons and the current-page indicator bar keep the exact accent color. Notes that High Contrast mode can lighten accent text further. Rewords the artwork guidance to emphasize logo visibility and readability over the login background.

Macroscope summarized 48ba804.

Quick104 and others added 2 commits November 20, 2026 21:38
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@coderabbitai

coderabbitai Bot commented Nov 21, 2026

Copy link
Copy Markdown

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

  • Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

@silo-triage silo-triage Bot added the size/S 0–49 added + deleted lines (all files); change volume, not priority. label Nov 21, 2026
@Quick104

Copy link
Copy Markdown
Contributor Author

Draft until Silo-Server/silo-server#4780 is merged into main. The docs describe that change, and its labels or defaults may still change in review.

@silo-kody

silo-kody Bot commented Nov 21, 2026 •

Copy link
Copy Markdown

Silo Kody — review complete

Review finished. Check the inline comments for findings and verify each suggestion against the code and tests.

Reviewing changes in Silo
  • Include the related issue, expected behavior, and validation steps in the PR description.
  • For API changes, describe the effect on Apple and Android clients and Jellyfin compatibility.
  • For plugin changes, identify the affected SDK contract, plugin, and catalog entry.
  • Follow this repository's AGENTS.md and CONTRIBUTING.md.
  • Request another review with @kody start-review in a PR comment.
  • React with 👍 or 👎 to give feedback on individual suggestions.
Review settings
Review Options

The following review options are enabled or disabled:

Options Enabled
Bug ✅
Performance ✅
Security ✅
Business Logic ❌
⚠️ 2 Kody Rule(s) were not evaluated

These rules declare that they need repository context beyond this diff, and the review could not retrieve it, so they were not judged on this pull request:

  • Scope polling setup steps to installable source capabilities
  • Preserve retired documentation URLs with tested redirects

@silo-triage silo-triage Bot added documentation Improvements or additions to documentation triaged High-confidence review completed; does not mean fixed, validated, or accepted for release. labels Nov 21, 2026
@github-actions

Copy link
Copy Markdown

Preview deployed: https://pr-448.siloserver-org.pages.dev

Commit 48ba804

Docs changes: 3 changes on 1 page. Each link opens the first change on its page. Step through the rest with the changes box in the corner of the preview.

Page Changes
Customize your server's appearance 3

The alias updates after a successful build and deployment. The preview is removed when this pull request closes.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation size/S 0–49 added + deleted lines (all files); change volume, not priority. triaged High-confidence review completed; does not mean fixed, validated, or accepted for release.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: say the accent color is lightened for text on the dark theme

1 participant