npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2025 – Pkg Stats / Ryan Hefner

scroll-snap

v5.0.2

Published

Snap page when user stops scrolling, with a customizable configuration and a consistent cross browser behaviour

Readme


npm npm npm downloads

Overview

scroll-snap is a powerful yet lightweight TypeScript library that provides smooth and customizable page snapping functionality. Built as a modern implementation of CSS Scroll Snap.

Features

  • 🪶 Lightweight (~2KB gzipped)
  • 🌐 Cross-browser support
  • 💪 Zero dependencies
  • 🎯 TypeScript ready
  • ⚡ Smooth animations
  • 🎨 Customizable settings
  • ⌨️ Keyboard navigation support
  • 🖱️ Optional navigation arrows

Installation

yarn add scroll-snap

Basic Usage

import createScrollSnap from 'scroll-snap'

const element = document.getElementById('container')
const { bind, unbind } = createScrollSnap(element, {
  snapDestinationY: '100%',
})

React Usage

Check out the React Hooks demo to see how to integrate scroll-snap in a React application.

Configuration Options

| Option | Type | Default | Description | | ---------------- | --------------------- | ------- | ---------------------------------------------- | | snapDestinationX | string | number | - | Horizontal snap points (e.g., '100%', '500px') | | snapDestinationY | string | number | - | Vertical snap points (e.g., '100%', '500px') | | timeout | number | 100 | Delay before snapping after scroll ends (ms) | | duration | number | 300 | Animation duration (ms) | | threshold | number | 0.2 | Scroll distance threshold (0 to 1) | | snapStop | boolean | false | Prevents skipping intermediate snap positions | | showArrows | boolean | false | Shows navigation arrows when hovering | | enableKeyboard | boolean | true | Enables keyboard arrow keys navigation | | easing | (t: number) => number | linear | Animation easing function |

Examples

Vertical Snapping
const scrollSnap = createScrollSnap(element, {
  snapDestinationY: '100vh',
  duration: 300,
  easing: t => t < 0.5 ? 2 * t * t : -1 + (4 - 2 * t) * t
})
Horizontal Scrolling Gallery
const scrollSnap = createScrollSnap(element, {
  snapDestinationX: '100%',
  showArrows: true,
  enableKeyboard: true
})
Custom Threshold
const scrollSnap = createScrollSnap(element, {
  snapDestinationY: '50vh',
  threshold: 0.4, // Requires more scroll distance to trigger snap
})

API Reference

Methods
bind()

Enables scroll snapping and attaches event listeners.

unbind()

Disables scroll snapping and removes event listeners.

Development

# Clone the repository
git clone https://github.com/lucafalasco/scroll-snap.git
cd scroll-snap

# Install dependencies
yarn

# Start development server with examples
yarn dev

# Run unit tests
yarn test

# Run integration tests
yarn test:e2e

# Build for production
yarn build

The dev server will start at http://localhost:8080 with hot reloading enabled and a playground environment for testing.

Contributing

  1. Fork the repository
  2. Create your feature branch: git checkout -b feature/my-feature
  3. Commit your changes: git commit -am 'Add my feature'
  4. Push to the branch: git push origin feature/my-feature
  5. Submit a pull request

Browser Support

  • Chrome 61+
  • Firefox 63+
  • Safari 11+
  • Edge 79+

License

MIT © Luca Falasco