stack-on-scroll
TypeScript icon, indicating that this package has built-in type declarations

1.0.5 • Public • Published

Stack-on-scroll

npm npm bundle size license issues

Stack-on-scroll is a lightweight and customizable JavaScript library to create visually engaging stacking effects as the user scrolls down the page. Ideal for storytelling and interactive layouts, it provides an elegant way to stack elements on top of each other dynamically.


✨ Features

  • Easy to Use: Minimal setup to get started with stacking effects.
  • Highly Customizable: Configure speed, transition effects, and offset options.
  • Lightweight & Fast: No dependencies, quick to load, and smooth transitions.
  • Flexible Design: Works with any HTML structure and is easily stylable.

📦 Installation

Install Stack-on-scroll via NPM or Yarn:

npm install stack-on-scroll
# or
yarn add stack-on-scroll

🚀 Quick Start

Follow these steps to get Stack-on-scroll running in your project.

1. Import and Initialize

import { Card, Outer } from 'stack-on-scroll';

function App() {
  return (
    <>
      <Outer>
        <Card index={1}>

          // Here is your custom code

        </Card>
        <Card index={2}>
          
          // Here is your custom code

        </Card>
        <Card index={3}>
          
          // Here is your custom code
        
        </Card>
      </Outer>
    </>
  );
}

export default App;

📺 Demo

Check out the Stack-on-scroll in action:

View Demo Site.

Stack on Scroll Demo


⚙️ Configuration Options

Option Type Default Description
index number Required Add index number on "Card" Component.

📚 Examples

Here's a quick example of how Stack-on-scroll can be used for a storytelling effect:

import { Card, Outer } from 'stack-on-scroll';

function App() {
  return (
    <>
      <Outer>
        <Card index={1}>

          // Here is your custom code

        </Card>
        <Card index={2}>
          
          // Here is your custom code

        </Card>
        <Card index={3}>
          
          // Here is your custom code
        
        </Card>
      </Outer>
    </>
  );
}

For more examples and customization options, check out the Documentation.


💻 Development

Want to contribute? Great! Follow these steps to set up your local environment:

  1. Clone the repository:

    git clone https://github.com/saadahmad888/stack-on-scroll.git
  2. Install dependencies:

    npm install
  3. Run the development server:

    npm start
  4. Build the project:

    npm run build

📄 License

This project is licensed under the MIT License. See the LICENSE file for more details.


🌟 Support

If you find Stack-on-scroll useful, please consider giving it a ⭐ on GitHub or sharing it with others!


Explore More

Discover a collection of unique, modern UI components by Saad Ahmad. Enhance your projects with cutting-edge designs and interactive elements.

Readme

Keywords

none

Package Sidebar

Install

npm i stack-on-scroll

Weekly Downloads

0

Version

1.0.5

License

ISC

Unpacked Size

67.4 kB

Total Files

8

Last publish

Collaborators

  • saadahmad