# perfect-scrollbar

> Minimalistic but perfect custom scrollbar plugin

Latest version **1.5.6** (published 2024-10-29) · MIT license · 0 weekly downloads

## Install

```sh
npm install perfect-scrollbar
pnpm add perfect-scrollbar
yarn add perfect-scrollbar
bun add perfect-scrollbar
```

## Health

**Score 40/100 (D)** — status: maintenance-mode.

Positive: has types; esm support; no vulnerabilities; high quality score.

Warnings: low downloads.

Negative: stale; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.5.6 |
| Published | 2024-10-29 |
| First published | 2014-10-21 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 0 |
| Unpacked size | 478 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 408 |
| Author | Hyunje Jun |
| Maintainers | piotrgusciora, makusref10, r-jacko, iprzybysz, rafalseifert, mako3577, trochonovitz, juujisai, shigure92, mleciejewski, bwsky, ascensus, smolenski-mikolaj, mdbootstrap, fkappa, aidzikowski, gbujanski |
| Keywords | frontend, scroll, scrollbar |

## Links

- npm: https://www.npmjs.com/package/perfect-scrollbar
- Repository: https://github.com/mdbootstrap/perfect-scrollbar
- Homepage: https://perfectscrollbar.com/
- Issues: https://github.com/mdbootstrap/perfect-scrollbar/issues
- npm.io page: https://npm.io/package/perfect-scrollbar

## Alternatives

- [@sentry/react-native](https://npm.io/package/@sentry/react-native.md) — 2.6M weekly downloads
- [@ardatan/aggregate-error](https://npm.io/package/@ardatan/aggregate-error.md) — 708.1K weekly downloads
- [custom-error-generator](https://npm.io/package/custom-error-generator.md) — 2.0K weekly downloads
- [@technik-sde/prosemirror-recreate-transform](https://npm.io/package/@technik-sde/prosemirror-recreate-transform.md) — 1.5K weekly downloads
- [@suchipi/error-utils](https://npm.io/package/@suchipi/error-utils.md) — 78 weekly downloads

## Recent versions

- 1.5.6 (latest) — 2024-10-29
- 1.5.5 — 2022-01-12
- 1.5.4 — 2022-01-12
- 1.5.3 — 2021-10-25
- 1.5.2 — 2021-07-19
- 1.5.1 — 2021-05-06
- 1.5.0 — 2020-01-16
- 1.4.0 — 2018-06-07
- 1.3.0 — 2017-12-01
- 1.2.0 — 2017-11-07
- 1.1.0 — 2017-10-19
- 1.0.3 — 2017-10-11
- 1.0.2 — 2017-10-10
- 1.0.1 — 2017-10-10
- 1.0.0 — 2017-10-10
- … 27 more at https://npm.io/package/perfect-scrollbar/versions

## README

<p align="center">
  <a href="https://perfectscrollbar.com/?utm_source=GitHub&utm_medium=PerfectScrollbar">
    <img src="https://perfectscrollbar.com/logo2.png" width="300" height="200">
  </a>
</p>

<h1 align="center">perfect-scrollbar</h1>

<p align="center">Minimalistic but perfect custom scrollbar plugin<p>


<p align="center">	
  <a href="https://npmcharts.com/compare/perfect-scrollbar?minimal=true"><img src="https://img.shields.io/npm/dm/perfect-scrollbar.svg" alt="Downloads"></a>
  <a href="https://github.com/mdbootstrap/bootstrap-material-design/blob/master/License.pdf"><img src="https://img.shields.io/badge/license-MIT-green.svg" alt="License"></a>	
  <a href="https://badge.fury.io/js/perfect-scrollbar"><img src="https://badge.fury.io/js/perfect-scrollbar.svg" alt="npm"></a>	
<a href="https://twitter.com/intent/tweet/?text=Thanks+@mdbootstrap+for+maintaining+amazing+and+free+Perfect+Scrollbar+Plugin%20https://perfectscrollbar.com/&hashtags=javascript,code,webdesign,bootstrap"><img src="https://img.shields.io/twitter/url/http/shields.io.svg?style=social&label=Let%20us%20know%20you%20were%20here%21&"></a>
<a href="https://www.youtube.com/watch?v=c9B4TPnak1A"><img alt="YouTube Video Views" src="https://img.shields.io/youtube/views/c9B4TPnak1A?label=Bootstrap%205%20Tutorial%20Views&style=social"></a>
</p>

________



## Why perfect-scrollbar?

perfect-scrollbar is minimalistic but *perfect* (for us, and maybe for most
developers) scrollbar plugin.

* No change on design layout
* No manipulation on DOM tree
* Use plain `scrollTop` and `scrollLeft`
* Scrollbar style is fully customizable
* Efficient update on layout change

We hope you will love it!

## Live preview

Check out the [Live Preview](https://mdbootstrap.com/snippets/standard/marveluck/3498209/?utm_source=GitHub&utm_medium=PerfectScrollbar) snippet. You can fork it right away for testing and experimenting purposes.



## Related resources


- [Scroll Back To Top](https://mdbootstrap.com/docs/standard/extended/back-to-top/?utm_source=GitHub&utm_medium=PerfectScrollbar)

- [Scrollspy](https://mdbootstrap.com/docs/standard/navigation/scrollspy/?utm_source=GitHub&utm_medium=PerfectScrollbar)

- [Scrollbar](https://mdbootstrap.com/docs/standard/methods/scrollbar/)

- [Scroll Status](https://mdbootstrap.com/docs/standard/plugins/scroll-status/?utm_source=GitHub&utm_medium=PerfectScrollbar)

## Social Media

 - [Twitter](https://twitter.com/MDBootstrap)

 - [Facebook](https://www.facebook.com/mdbootstrap) 

 - [Pinterest](https://pl.pinterest.com/mdbootstrap)

 - [Dribbble](https://dribbble.com/mdbootstrap)

 - [LinkedIn](https://www.linkedin.com/company/material-design-for-bootstrap)
 
 - [YouTube](https://www.youtube.com/channel/UC5CF7mLQZhvx8O5GODZAhdA)

## Get Free Material Design for Bootstrap 5

<table>
  <tbody>
    <tr>
      <td>
          <a href="https://mdbootstrap.com/docs/standard/" alt="Bootstrap 5" rel="dofollow">
          		<img src="https://mdbcdn.b-cdn.net/wp-content/themes/mdbootstrap4/content/en/_mdb5/standard/pro/_main/assets/mdb5-about-v2.jpg">
          </a>
      </td>
      <td>
        <ul style="list-style-type:none;">
        <li>Material Design 2.0 + latest Bootstrap 5 based on plain JavaScript. 700+ material UI components, super simple, 1 minute installation, free templates & much more</li>      
</ul>
      </td>
    </tr>
   </tbody>
</table>

## Free Tutorials

Huge collection of free and high-quality tutorials. Learn Bootstrap, Angular, React, Vue, WordPress and many more. Create your own websites and apps.


[Check it out](https://www.youtube.com/c/Mdbootstrap)

---
_Source: https://npm.io/package/perfect-scrollbar · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._