macos-scrollbar

Hide native macOS scrollbars and render themed overlay scrollbars for WKWebView content.

9|3|Updated Jan 13, 2026
One-click install
npx skills add https://github.com/firstloophq/nomendex --skill macos-scrollbar
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: macos-scrollbar
Source: https://github.com/firstloophq/nomendex/tree/main/.claude/skills/macos-scrollbar
Command: npx skills add https://github.com/firstloophq/nomendex --skill macos-scrollbar

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

WKWebView on macOS does not support standard CSS scrollbar styling, causing inconsistent scrollbar appearance between the native app and web content.

Core Features & Use Cases

  • Negative margin technique to hide the native scrollbar while keeping scroll functionality.
  • Overlay themed scrollbar rendering that matches the app's theme.
  • Supports scroll position persistence across tabs or sections within WKWebView content.

Quick Start

Integrate the OverlayScrollbar in your macOS WKWebView UI to apply a themed, persistent scrollbar.

Frequently Asked Questions about macos-scrollbar

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I style a custom scrollbar in WKWebView on macOS?

To style a custom scrollbar in WKWebView on macOS, you can use a negative margin technique to hide the native scrollbar while rendering a themed overlay scrollbar container for consistent UI theming.

Why does CSS scrollbar styling not work in macOS WKWebView?

CSS scrollbar styling does not work in macOS WKWebView because the native environment does not support standard web scrollbar styling, causing inconsistent appearance between the app shell and web content.

Can I apply a themed scrollbar to macOS WKWebView without losing scroll functionality?

You can apply a themed scrollbar to macOS WKWebView by using a negative margin to hide the native scrollbar visually while keeping the underlying scroll functionality fully intact for the user.

How do I persist scroll position across tabs in a WKWebView app?

To persist scroll position across tabs in a WKWebView app, integrate an overlay scrollbar component that includes built-in persistence support to maintain scrollable inner content states.

What is the best way to hide the native scrollbar in macOS WKWebView?

The best way to hide the native scrollbar in macOS WKWebView is applying a negative margin technique, which conceals the default scrollbar while allowing a custom themed overlay to render.

Are there limitations to using overlay scrollbars in WKWebView apps?

Overlay scrollbars in WKWebView apps require managing an overlay container and a scrollable inner area separately, meaning you must ensure the themed overlay correctly tracks the inner scroll state without native UI conflicts.