Tiny Slider

A lightweight, vanilla JavaScript slider library for creating smooth carousels and galleries. No dependencies, just pure performance.

Get Started API Reference

Zero dependencies

5.3k+ GitHub stars

IE8+ support

Quick Start

Get your first slider running in under a minute

Install the package

Install Tiny Slider via npm, yarn, or load it from a CDN.

npm install tiny-slider

Add your HTML markup

Create a container element with your slides. Use a div or ul as the container.

<div class="my-slider">
  <div>Slide 1</div>
  <div>Slide 2</div>
  <div>Slide 3</div>
</div>

Initialize the slider

Import the tns function and initialize your slider with options.

import { tns } from 'tiny-slider';

const slider = tns({
  container: '.my-slider',
  items: 1,
  slideBy: 'page',
  autoplay: true,
  controls: true,
  nav: true
});

See the result

Your slider is now active with navigation controls, dots, and autoplay. The slider will automatically adapt to different screen sizes and provide touch/swipe support on mobile devices.

Key Features

Everything you need for modern sliders

Carousel & Gallery

Two distinct modes: carousel for continuous sliding and gallery for fade transitions

Responsive

Breakpoint-based configuration for perfect layouts on any screen size

Touch Support

Native touch and mouse drag support with swipe detection

Autoplay

Automatic slide progression with hover pause and direction control

Lazy Loading

Load images only when needed to improve performance

Accessibility

ARIA attributes and keyboard navigation built in

Explore the Documentation

Dive deeper into Tiny Slider’s capabilities

Installation Guide

Detailed installation instructions for all package managers and module systems

View guide

Configuration Options

Complete reference for all configuration options with examples

Explore options

Methods & Events

Programmatic control with methods and custom event listeners

View API

Live Examples

Real-world examples showing different slider configurations

Browse examples

Ready to build your slider?

Join thousands of developers using Tiny Slider to create beautiful, performant carousels and galleries

Start Building

Documentation Index