Skip to content

docs: Add custom scrollbar styling to match brand theme #1165

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
goingforstudying-ctrl wants to merge 2 commits into
base: main
Choose a base branch
from
Open

docs: Add custom scrollbar styling to match brand theme #1165

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
e0e41c6
docs: Add custom scrollbar styling to match brand theme
Mar 19, 2026
7b24a77
fix: address review feedback - narrow transition scope, fix dark mode…
Mar 28, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 5 additions & 4 deletions website/src/css/custom.css
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,3 +1,4 @@
@import "./scrollbar.css";
@tailwind base;
@tailwind components;
@tailwind utilities;
Expand Down Expand Up @@ -5366,21 +5367,21 @@ nav.table-of-contents .table-of-contents__link--active,
}

.tableOfContents::-webkit-scrollbar-thumb {
background-color: rgba(107, 114, 128, 0.3);
background-color: rgba(16, 185, 129, 0.3);
border-radius: 10px;
}

.tableOfContents::-webkit-scrollbar-thumb:hover {
background-color: rgba(107, 114, 128, 0.5);
background-color: rgba(16, 185, 129, 0.5);
}

/* Dark mode scrollbar */
[data-theme="dark"] .tableOfContents::-webkit-scrollbar-thumb {
background-color: rgba(156, 163, 175, 0.3);
background-color: rgba(16, 185, 129, 0.25);
}

[data-theme="dark"] .tableOfContents::-webkit-scrollbar-thumb:hover {
background-color: rgba(156, 163, 175, 0.5);
background-color: rgba(16, 185, 129, 0.45);
}

/* Animate the active TOC item */
Expand Down
61 changes: 61 additions & 0 deletions website/src/css/scrollbar.css
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,61 @@
/* ============================================
Custom Scrollbar Styling - VoltAgent Brand
Issue #1157
============================================ */

/* Light Mode Scrollbar */
::-webkit-scrollbar {
width: 8px;
height: 8px;
}

::-webkit-scrollbar-track {
background: rgba(0, 0, 0, 0.05);
border-radius: 4px;
}

::-webkit-scrollbar-thumb {
background: rgba(16, 185, 129, 0.3);
border-radius: 4px;
transition: background-color 0.2s ease;
}

::-webkit-scrollbar-thumb:hover {
background: rgba(16, 185, 129, 0.5);
}
Comment on lines +17 to +25
Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai bot Mar 19, 2026

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟠 Major

Increase default thumb contrast to meet accessibility intent.

Current default thumb opacity is too subtle (especially Line 18 and Line 37), making the scrollbar hard to perceive in both themes. This conflicts with the PR’s accessibility objective.

🎯 Suggested contrast-safe adjustment 
 ::-webkit-scrollbar-thumb {
-  background: rgba(16, 185, 129, 0.3);
+  background: rgba(16, 185, 129, 0.55);
   border-radius: 4px;
-  transition: all 0.2s ease;
+  transition: background-color 0.2s ease;
 }
 
 ::-webkit-scrollbar-thumb:hover {
-  background: rgba(16, 185, 129, 0.5);
+  background: rgba(16, 185, 129, 0.75);
 }
 
 html[data-theme="dark"] ::-webkit-scrollbar-thumb {
-  background: rgba(16, 185, 129, 0.25);
+  background: rgba(16, 185, 129, 0.5);
 }
 
 html[data-theme="dark"] ::-webkit-scrollbar-thumb:hover {
-  background: rgba(16, 185, 129, 0.45);
+  background: rgba(16, 185, 129, 0.7);
 }
 
 * {
   scrollbar-width: thin;
-  scrollbar-color: rgba(16, 185, 129, 0.3) transparent;
+  scrollbar-color: rgba(16, 185, 129, 0.55) transparent;
 }
 
 html[data-theme="dark"] * {
-  scrollbar-color: rgba(16, 185, 129, 0.25) rgba(255, 255, 255, 0.05);
+  scrollbar-color: rgba(16, 185, 129, 0.5) rgba(255, 255, 255, 0.08);
 }

Also applies to: 36-42, 45-52

🤖 Prompt for AI Agents 
Verify each finding against the current code and only fix it if needed.

In `@website/src/css/scrollbar.css` around lines 17 - 25, The scrollbar thumb
opacity is too low for accessibility; update the ::-webkit-scrollbar-thumb
default and hover styles to higher-contrast values (e.g., increase rgba alpha
from 0.3 to around 0.6 for the default and from 0.5 to around 0.8 for :hover) so
the green thumb is more visible, and apply the same adjustment to the other
similar blocks referenced (lines covering the alternate theme selectors around
36-42 and 45-52) — modify the CSS rules for ::-webkit-scrollbar-thumb and
::-webkit-scrollbar-thumb:hover accordingly.


::-webkit-scrollbar-corner {
background: transparent;
}

/* Dark Mode Scrollbar */
html[data-theme="dark"] ::-webkit-scrollbar-track {
background: rgba(255, 255, 255, 0.05);
}

html[data-theme="dark"] ::-webkit-scrollbar-thumb {
background: rgba(16, 185, 129, 0.25);
}

html[data-theme="dark"] ::-webkit-scrollbar-thumb:hover {
background: rgba(16, 185, 129, 0.45);
}

/* Firefox Support */
html {
scrollbar-width: thin;
scrollbar-color: rgba(16, 185, 129, 0.3) transparent;
}

html[data-theme="dark"] {
scrollbar-color: rgba(16, 185, 129, 0.25) rgba(255, 255, 255, 0.05);
}

* {
scrollbar-width: thin;
scrollbar-color: rgba(16, 185, 129, 0.3) transparent;
}

html[data-theme="dark"] * {
scrollbar-color: rgba(16, 185, 129, 0.25) rgba(255, 255, 255, 0.05);
}