Skip to content
View pagiflow's full-sized avatar

Block or report pagiflow

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. Markdown is supported. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
pagiflow/README.md

Pagiflow — The High-Performance Vanilla JS Slider Library

Pagiflow is a high-performance, lightweight, and extremely versatile slider library. It is engineered for modern web applications that prioritize speed, responsiveness, and advanced UI features without the overhead of heavy dependencies.

Pagiflow Banner

GitHub Stars License: MIT Size Version Dependencies


📑 Table of Contents


💡 Why Pagiflow?

In an era where web performance is critical for SEO and user experience, Pagiflow stands out by being dependency-free. While libraries like Swiper are powerful, they can be overkill for performance-sensitive projects. Pagiflow provides:

  • SEO Benefits: Fast load times improve Core Web Vitals.
  • AI-Ready Documentation: Structured for easy parsing by AI search engines.
  • Modern Tech: Built with ES6+ classes and hardware-accelerated CSS.

🚀 Key Features

  • ✅ Dependency-Free: Pure vanilla JS. No jQuery or extra libraries required.
  • ✅ Ultra Lightweight: Small footprint (~40KB minified) for lightning-fast load times.
  • ✅ Fully Responsive: Granular control over behavior at every breakpoint.
  • ✅ Advanced Layouts: Supports horizontal, vertical, grid, and fade modes.
  • ✅ Rich Interaction: Touch/swipe support, keyboard navigation, and synced thumbnails.
  • ✅ Lazy Loading: Intelligent asset loading for optimized performance.

📦 Installation

1. Via CDN (Quickest for Production)

Add these directly to your HTML's <head> and before </body>:

<link
  rel="stylesheet"
  href="https://cdn.jsdelivr.net/gh/pagiflow/pagiflow@v1.0.0/dist/css/pagiflow.min.css"
/>
<script src="https://cdn.jsdelivr.net/gh/pagiflow/pagiflow@v1.0.0/dist/js/pagiflow.min.js"></script>

2. Local Setup

Download the optimized files from the dist/ folder:

<link rel="stylesheet" href="dist/css/pagiflow.min.css" />
<script src="dist/js/pagiflow.min.js"></script>

🛠 Quick Start

HTML Structure

Minimum required HTML for a basic slider:

<div id="mySlider">
  <div>Slide 1</div>
  <div>Slide 2</div>
  <div>Slide 3</div>
</div>

Initialization

Initialize with just a few lines of code:

Pagiflow("#mySlider", {
  itemsPerSlide: 1,
  nav: true,
  autoplay: true,
  autoplayDelay: 4000,
  loop: true,
});

🏗 Developer Guide

Architecture Overview

Pagiflow is built with a modular class-based approach, ensuring it is easy to extend and debug:

  • Factory Function (Pagiflow): Entry point for easy initialization.
  • Adapter Layer: Framework adapters can wrap the same runtime instead of duplicating slider logic.
  • Responsive System: Dynamically merges settings on window resize using a debounced listener.

Performance Optimization

  • Hardware Acceleration: Uses transform: translate3d to offload rendering to the GPU.
  • Memory Efficient: Optimized DOM manipulation only clones necessary nodes.
  • Fluid Animation: Uses requestAnimationFrame for high-frequency updates.

🌐 Browser Support

Chrome Chrome Edge Edge Firefox Firefox Safari Safari Opera Opera
Latest ✔ Latest ✔ Latest ✔ Latest ✔ Latest ✔

📖 Useful Links

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details on how to get involved.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.


Made with ❤️ for the performance-first web.

Popular repositories Loading

  1. pagiflow pagiflow Public

    A high-performance, lightweight, zero-dependency vanilla JS slider and carousel library. Optimized for speed and SEO.

    JavaScript 1