Improve Sidebar Accessibility and Fix Syntax Highlighting in Dark Mode#98
Open
tinyfroggy wants to merge 1 commit intoibelick:mainfrom
Open
Improve Sidebar Accessibility and Fix Syntax Highlighting in Dark Mode#98tinyfroggy wants to merge 1 commit intoibelick:mainfrom
tinyfroggy wants to merge 1 commit intoibelick:mainfrom
Conversation
…ith professional transformers. - Fixed Dark Mode: Restored syntax highlighting by removing forced white-text overrides. - Sidebar Fixes: Enabled natural scrolling and removed redundant padding/hacks.
Contributor
|
@tinyfroggy is attempting to deploy a commit to the julienthibeaut's projects Team on Vercel. A member of the Team first needs to authorize it. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
This PR focuses on improving usability and accessibility by removing fragile UI workarounds and replacing them with more robust, standards-based solutions. These issues became especially noticeable due to a hardware limitation on my side, which helped surface real accessibility problems.
Changes
My mouse scroll wheel is currently broken, which unintentionally exposed a major usability issue in the documentation sidebar. Due to restrictive bottom padding (pb-20) and custom scrollbar CSS, navigating the sidebar without a perfectly functioning scroll wheel was extremely difficult.
To address this, I removed these layout and scrollbar “hacks” and restored a standard, native scrolling behavior. This makes the sidebar reliably navigable for:
Users with hardware limitations
Trackpad users with non-default scrolling settings
Anyone relying on standard OS/browser scrolling behavior
Overall, this significantly improves accessibility and day-to-day usability.
Code blocks in dark mode were previously broken due to aggressive !important overrides that forced most syntax colors to white, flattening the visual hierarchy and harming readability.
I replaced these overrides with a proper dual-theme syntax highlighting setup using GitHub Light and GitHub Dark themes. Syntax highlighting is now:
Fully readable in both light and dark modes
Consistent with the app’s theme system
Free of manual CSS patches or forced overrides