Forem: Joseph Nelson

Advanced Instagram-Style Zoom Sliders with react-instagram-zoom-slider in React

Joseph Nelson — Mon, 19 Jan 2026 17:26:07 +0000

react-instagram-zoom-slider is a React component library for creating Instagram-style image sliders with pinch-to-zoom functionality. It provides smooth touch gestures, zoom interactions, and swipe navigation similar to Instagram's image viewer. This guide walks through advanced usage of react-instagram-zoom-slider with React, including zoom controls, gesture handling, and complex slider configurations. This is part 60 of a series on using react-instagram-zoom-slider with React.

Prerequisites

Before you begin, make sure you have:

Node.js version 14.0 or higher installed
npm, yarn, or pnpm package manager
A React project (version 16.8 or higher) or create-react-app setup
Basic knowledge of React hooks (useState, useEffect, useRef)
Familiarity with touch events and gestures
Understanding of CSS transforms and animations

Installation

Install react-instagram-zoom-slider using your preferred package manager:

npm install react-instagram-zoom-slider

Or with yarn:

yarn add react-instagram-zoom-slider

Or with pnpm:

pnpm add react-instagram-zoom-slider

After installation, your package.json should include:

{
  "dependencies": {
    "react-instagram-zoom-slider": "^1.0.0",
    "react": "^18.0.0",
    "react-dom": "^18.0.0"
  }
}

Project Setup

react-instagram-zoom-slider requires minimal setup. Import the component and you're ready to use it.

First Example / Basic Usage

Let's create a simple zoom slider. Create a new file src/ZoomSliderExample.jsx:

// src/ZoomSliderExample.jsx
import React from 'react';
import InstagramZoomSlider from 'react-instagram-zoom-slider';

function ZoomSliderExample() {
  const images = [
    'https://via.placeholder.com/800x600/007bff/ffffff?text=Image+1',
    'https://via.placeholder.com/800x600/28a745/ffffff?text=Image+2',
    'https://via.placeholder.com/800x600/ffc107/000000?text=Image+3',
    'https://via.placeholder.com/800x600/dc3545/ffffff?text=Image+4'
  ];

  return (
    <div style={{ padding: '20px', maxWidth: '800px', margin: '0 auto' }}>
      <h2>Instagram Zoom Slider Example</h2>
      <div style={{ height: '600px', border: '1px solid #ddd', borderRadius: '8px', overflow: 'hidden' }}>
        <InstagramZoomSlider
          images={images}
          width="100%"
          height="100%"
        />
      </div>
    </div>
  );
}

export default ZoomSliderExample;

Update your App.jsx:

// src/App.jsx
import React from 'react';
import ZoomSliderExample from './ZoomSliderExample';
import './App.css';

function App() {
  return (
    <div className="App">
      <ZoomSliderExample />
    </div>
  );
}

export default App;

This creates a basic Instagram-style slider with zoom functionality.

Understanding the Basics

react-instagram-zoom-slider provides several key features:

InstagramZoomSlider component: Main slider component
Pinch-to-zoom: Touch gesture support for zooming
Swipe navigation: Swipe between images
Double-tap zoom: Double-tap to zoom in/out
Smooth animations: Smooth transitions and zoom effects
Responsive: Works on mobile and desktop

Key concepts for advanced usage:

Image array: Pass array of image URLs
Zoom controls: Automatic zoom controls on touch/click
Gesture handling: Built-in support for pinch and swipe gestures
Customization: Configurable zoom levels and behavior
Event handling: Callbacks for slide changes and interactions

Here's an example with custom configuration:

// src/AdvancedZoomSliderExample.jsx
import React, { useState } from 'react';
import InstagramZoomSlider from 'react-instagram-zoom-slider';

function AdvancedZoomSliderExample() {
  const [currentIndex, setCurrentIndex] = useState(0);

  const images = [
    'https://via.placeholder.com/800x600/007bff/ffffff?text=Image+1',
    'https://via.placeholder.com/800x600/28a745/ffffff?text=Image+2',
    'https://via.placeholder.com/800x600/ffc107/000000?text=Image+3',
    'https://via.placeholder.com/800x600/dc3545/ffffff?text=Image+4',
    'https://via.placeholder.com/800x600/6c757d/ffffff?text=Image+5'
  ];

  const handleSlideChange = (index) => {
    setCurrentIndex(index);
    console.log(`Slide changed to index: ${index}`);
  };

  return (
    <div style={{ padding: '20px', maxWidth: '900px', margin: '0 auto' }}>
      <h2>Advanced Zoom Slider</h2>
      <div style={{ marginBottom: '20px', textAlign: 'center', color: '#666' }}>
        Image {currentIndex + 1} of {images.length}
      </div>
      <div style={{ height: '600px', border: '1px solid #ddd', borderRadius: '8px', overflow: 'hidden' }}>
        <InstagramZoomSlider
          images={images}
          width="100%"
          height="100%"
          onSlideChange={handleSlideChange}
          showDots={true}
          showArrows={true}
        />
      </div>
    </div>
  );
}

export default AdvancedZoomSliderExample;

Practical Example / Building Something Real

Let's build a comprehensive image gallery with zoom functionality:

// src/ImageGalleryZoomSlider.jsx
import React, { useState } from 'react';
import InstagramZoomSlider from 'react-instagram-zoom-slider';

function ImageGalleryZoomSlider() {
  const [currentIndex, setCurrentIndex] = useState(0);
  const [isFullscreen, setIsFullscreen] = useState(false);

  const images = [
    {
      url: 'https://via.placeholder.com/1200x800/007bff/ffffff?text=Image+1',
      title: 'Image 1',
      description: 'Description for image 1'
    },
    {
      url: 'https://via.placeholder.com/1200x800/28a745/ffffff?text=Image+2',
      title: 'Image 2',
      description: 'Description for image 2'
    },
    {
      url: 'https://via.placeholder.com/1200x800/ffc107/000000?text=Image+3',
      title: 'Image 3',
      description: 'Description for image 3'
    },
    {
      url: 'https://via.placeholder.com/1200x800/dc3545/ffffff?text=Image+4',
      title: 'Image 4',
      description: 'Description for image 4'
    },
    {
      url: 'https://via.placeholder.com/1200x800/6c757d/ffffff?text=Image+5',
      title: 'Image 5',
      description: 'Description for image 5'
    }
  ];

  const imageUrls = images.map(img => img.url);

  const handleSlideChange = (index) => {
    setCurrentIndex(index);
  };

  const handleFullscreen = () => {
    setIsFullscreen(!isFullscreen);
  };

  return (
    <div style={{ padding: '20px', maxWidth: '1000px', margin: '0 auto' }}>
      <h1>Image Gallery with Zoom</h1>

      <div style={{
        position: isFullscreen ? 'fixed' : 'relative',
        top: isFullscreen ? 0 : 'auto',
        left: isFullscreen ? 0 : 'auto',
        right: isFullscreen ? 0 : 'auto',
        bottom: isFullscreen ? 0 : 'auto',
        width: isFullscreen ? '100vw' : '100%',
        height: isFullscreen ? '100vh' : '700px',
        backgroundColor: isFullscreen ? '#000' : 'transparent',
        zIndex: isFullscreen ? 9999 : 1,
        display: 'flex',
        flexDirection: 'column',
        justifyContent: 'center',
        alignItems: 'center'
      }}>
        <div style={{
          width: '100%',
          height: isFullscreen ? '100%' : '100%',
          border: isFullscreen ? 'none' : '1px solid #ddd',
          borderRadius: isFullscreen ? 0 : '8px',
          overflow: 'hidden',
          position: 'relative'
        }}>
          <InstagramZoomSlider
            images={imageUrls}
            width="100%"
            height="100%"
            onSlideChange={handleSlideChange}
            showDots={true}
            showArrows={true}
          />
          {isFullscreen && (
            <button
              onClick={handleFullscreen}
              style={{
                position: 'absolute',
                top: '20px',
                right: '20px',
                padding: '10px 20px',
                backgroundColor: 'rgba(255,255,255,0.9)',
                color: '#333',
                border: 'none',
                borderRadius: '4px',
                cursor: 'pointer',
                zIndex: 10000
              }}
            >
              Exit Fullscreen
            </button>
          )}
        </div>
        {!isFullscreen && (
          <div style={{ marginTop: '20px', textAlign: 'center' }}>
            <div style={{ marginBottom: '10px' }}>
              <h3>{images[currentIndex].title}</h3>
              <p style={{ color: '#666' }}>{images[currentIndex].description}</p>
            </div>
            <button
              onClick={handleFullscreen}
              style={{
                padding: '10px 20px',
                backgroundColor: '#007bff',
                color: 'white',
                border: 'none',
                borderRadius: '4px',
                cursor: 'pointer'
              }}
            >
              View Fullscreen
            </button>
          </div>
        )}
      </div>

      <div style={{ marginTop: '20px', display: 'flex', justifyContent: 'center', gap: '10px' }}>
        {images.map((image, index) => (
          <img
            key={index}
            src={image.url}
            alt={image.title}
            onClick={() => setCurrentIndex(index)}
            style={{
              width: '100px',
              height: '100px',
              objectFit: 'cover',
              borderRadius: '4px',
              cursor: 'pointer',
              border: currentIndex === index ? '3px solid #007bff' : '1px solid #ddd',
              opacity: currentIndex === index ? 1 : 0.7
            }}
          />
        ))}
      </div>
    </div>
  );
}

export default ImageGalleryZoomSlider;

Now create a product image viewer:

// src/ProductImageViewer.jsx
import React, { useState } from 'react';
import InstagramZoomSlider from 'react-instagram-zoom-slider';

function ProductImageViewer() {
  const [selectedImageIndex, setSelectedImageIndex] = useState(0);

  const productImages = [
    'https://via.placeholder.com/800x800/007bff/ffffff?text=Product+View+1',
    'https://via.placeholder.com/800x800/28a745/ffffff?text=Product+View+2',
    'https://via.placeholder.com/800x800/ffc107/000000?text=Product+View+3',
    'https://via.placeholder.com/800x800/dc3545/ffffff?text=Product+View+4'
  ];

  return (
    <div style={{ padding: '20px', maxWidth: '1000px', margin: '0 auto' }}>
      <h2>Product Image Viewer</h2>
      <div style={{ display: 'flex', gap: '20px' }}>
        <div style={{ flex: 1 }}>
          <div style={{ height: '600px', border: '1px solid #ddd', borderRadius: '8px', overflow: 'hidden' }}>
            <InstagramZoomSlider
              images={productImages}
              width="100%"
              height="100%"
              onSlideChange={setSelectedImageIndex}
              showDots={true}
              showArrows={true}
            />
          </div>
        </div>
        <div style={{ flex: 1 }}>
          <h3>Product Details</h3>
          <p>Use pinch-to-zoom or double-tap to zoom in on product images.</p>
          <p>Swipe left or right to navigate between product views.</p>
          <div style={{ marginTop: '20px' }}>
            <p>Current view: {selectedImageIndex + 1} of {productImages.length}</p>
          </div>
        </div>
      </div>
    </div>
  );
}

export default ProductImageViewer;

Update your App.jsx:

// src/App.jsx
import React from 'react';
import ImageGalleryZoomSlider from './ImageGalleryZoomSlider';
import ProductImageViewer from './ProductImageViewer';
import './App.css';

function App() {
  return (
    <div className="App">
      <ImageGalleryZoomSlider />
      <ProductImageViewer />
    </div>
  );
}

export default App;

This example demonstrates:

Image gallery with zoom functionality
Fullscreen mode
Thumbnail navigation
Product image viewer
Slide change callbacks
Custom controls

Common Issues / Troubleshooting

Zoom not working: Ensure touch events are properly handled. The library requires touch support for pinch-to-zoom. On desktop, use mouse wheel or double-click.
Images not loading: Check that image URLs are valid and accessible. Use absolute URLs or ensure relative paths are correct.
Slider not responding: Make sure the container has proper dimensions (width and height). The slider needs explicit dimensions to function correctly.
Gestures not working: Touch gestures require proper event handling. Ensure there are no CSS conflicts preventing touch events.
Fullscreen issues: When implementing fullscreen, ensure proper z-index and positioning. The slider container needs to be properly sized for fullscreen mode.
Performance: For large image sets, consider lazy loading or image optimization. Large images can impact performance, especially on mobile devices.

Next Steps

Now that you have an advanced understanding of react-instagram-zoom-slider:

Explore advanced zoom configurations
Learn about custom gesture handling
Implement image lazy loading
Add custom navigation controls
Create custom zoom animations
Integrate with image optimization libraries
Learn about other zoom slider libraries
Check the official repository: https://github.com/skozer/react-instagram-zoom-slider
Look for part 61 of this series for more advanced topics

Summary

You've successfully integrated react-instagram-zoom-slider into your React application with advanced features including zoom functionality, fullscreen mode, thumbnail navigation, and product image viewing. react-instagram-zoom-slider provides an Instagram-like experience for image viewing with smooth gestures and zoom interactions.

SEO Keywords

react-instagram-zoom-slider
React Instagram slider
react-instagram-zoom-slider tutorial
React zoom slider
react-instagram-zoom-slider installation
React pinch to zoom
react-instagram-zoom-slider example
React image zoom
react-instagram-zoom-slider setup
React touch slider
react-instagram-zoom-slider customization
React image gallery zoom
react-instagram-zoom-slider gestures
React zoom library
react-instagram-zoom-slider getting started

Building Touch Sliders with react-id-swiper in React

Joseph Nelson — Mon, 19 Jan 2026 17:21:47 +0000

react-id-swiper is a React wrapper for Swiper.js, a powerful touch slider library. It provides a React-friendly API for creating touch-enabled sliders, carousels, and galleries with touch gestures, navigation controls, and extensive customization options. This guide walks through setting up and creating touch sliders using react-id-swiper with React, from installation to a working implementation. This is part 59 of a series on using react-id-swiper with React.

Prerequisites

Before you begin, make sure you have:

Node.js version 14.0 or higher installed
npm, yarn, or pnpm package manager
A React project (version 16.8 or higher) or create-react-app setup
Basic knowledge of React hooks (useState, useEffect, useRef)
Familiarity with JavaScript/TypeScript
Understanding of touch events

Installation

Install react-id-swiper and Swiper dependencies:

npm install react-id-swiper swiper

Or with yarn:

yarn add react-id-swiper swiper

Or with pnpm:

pnpm add react-id-swiper swiper

After installation, your package.json should include:

{
  "dependencies": {
    "react-id-swiper": "^3.0.0",
    "swiper": "^8.0.0",
    "react": "^18.0.0",
    "react-dom": "^18.0.0"
  }
}

Project Setup

Import Swiper CSS in your main entry file:

// src/index.js
import React from 'react';
import ReactDOM from 'react-dom/client';
import 'swiper/css';
import 'swiper/css/navigation';
import 'swiper/css/pagination';
import App from './App';

const root = ReactDOM.createRoot(document.getElementById('root'));
root.render(
  <React.StrictMode>
    <App />
  </React.StrictMode>
);

First Example / Basic Usage

Let's create a simple image slider. Create a new file src/SwiperExample.jsx:

// src/SwiperExample.jsx
import React from 'react';
import SwiperCore, { Navigation, Pagination } from 'swiper';
import { Swiper, SwiperSlide } from 'react-id-swiper';
import 'swiper/css';
import 'swiper/css/navigation';
import 'swiper/css/pagination';

SwiperCore.use([Navigation, Pagination]);

function SwiperExample() {
  const images = [
    'https://via.placeholder.com/800x400/007bff/ffffff?text=Slide+1',
    'https://via.placeholder.com/800x400/28a745/ffffff?text=Slide+2',
    'https://via.placeholder.com/800x400/ffc107/000000?text=Slide+3',
    'https://via.placeholder.com/800x400/dc3545/ffffff?text=Slide+4'
  ];

  const params = {
    navigation: {
      nextEl: '.swiper-button-next',
      prevEl: '.swiper-button-prev'
    },
    pagination: {
      el: '.swiper-pagination',
      clickable: true
    },
    spaceBetween: 30
  };

  return (
    <div style={{ padding: '20px', maxWidth: '800px', margin: '0 auto' }}>
      <h2>Basic Swiper Example</h2>
      <Swiper {...params}>
        {images.map((image, index) => (
          <SwiperSlide key={index}>
            <img
              src={image}
              alt={`Slide ${index + 1}`}
              style={{ width: '100%', height: '100%', objectFit: 'cover' }}
            />
          </SwiperSlide>
        ))}
      </Swiper>
    </div>
  );
}

export default SwiperExample;

Update your App.jsx:

// src/App.jsx
import React from 'react';
import SwiperExample from './SwiperExample';
import './App.css';

function App() {
  return (
    <div className="App">
      <SwiperExample />
    </div>
  );
}

export default App;

This creates a basic touch-enabled slider with navigation and pagination.

Understanding the Basics

react-id-swiper provides React components for Swiper:

Swiper: Main slider container component
SwiperSlide: Individual slide component
SwiperCore: Core Swiper functionality
Modules: Navigation, Pagination, Autoplay, etc.
Configuration: Extensive configuration options via params

Key concepts:

Modules: Import and use Swiper modules (Navigation, Pagination, etc.)
Params object: Configure slider behavior through params
Touch gestures: Built-in swipe/touch support
Responsive: Automatic responsive behavior
Customization: Extensive styling and behavior options

Here's an example with autoplay and custom styling:

// src/AdvancedSwiperExample.jsx
import React from 'react';
import SwiperCore, { Navigation, Pagination, Autoplay } from 'swiper';
import { Swiper, SwiperSlide } from 'react-id-swiper';
import 'swiper/css';
import 'swiper/css/navigation';
import 'swiper/css/pagination';

SwiperCore.use([Navigation, Pagination, Autoplay]);

function AdvancedSwiperExample() {
  const images = [
    'https://via.placeholder.com/800x400/007bff/ffffff?text=Slide+1',
    'https://via.placeholder.com/800x400/28a745/ffffff?text=Slide+2',
    'https://via.placeholder.com/800x400/ffc107/000000?text=Slide+3',
    'https://via.placeholder.com/800x400/dc3545/ffffff?text=Slide+4'
  ];

  const params = {
    navigation: {
      nextEl: '.swiper-button-next',
      prevEl: '.swiper-button-prev'
    },
    pagination: {
      el: '.swiper-pagination',
      clickable: true,
      dynamicBullets: true
    },
    autoplay: {
      delay: 3000,
      disableOnInteraction: false
    },
    loop: true,
    spaceBetween: 30,
    slidesPerView: 1,
    breakpoints: {
      640: {
        slidesPerView: 1,
        spaceBetween: 20
      },
      768: {
        slidesPerView: 2,
        spaceBetween: 30
      },
      1024: {
        slidesPerView: 3,
        spaceBetween: 40
      }
    }
  };

  return (
    <div style={{ padding: '20px', maxWidth: '1200px', margin: '0 auto' }}>
      <h2>Advanced Swiper with Autoplay</h2>
      <Swiper {...params}>
        {images.map((image, index) => (
          <SwiperSlide key={index}>
            <div style={{
              height: '300px',
              display: 'flex',
              alignItems: 'center',
              justifyContent: 'center',
              backgroundColor: '#f8f9fa',
              borderRadius: '8px',
              overflow: 'hidden'
            }}>
              <img
                src={image}
                alt={`Slide ${index + 1}`}
                style={{ width: '100%', height: '100%', objectFit: 'cover' }}
              />
            </div>
          </SwiperSlide>
        ))}
      </Swiper>
    </div>
  );
}

export default AdvancedSwiperExample;

Practical Example / Building Something Real

Let's build a comprehensive image gallery with thumbnails:

// src/ImageGallerySwiper.jsx
import React, { useState } from 'react';
import SwiperCore, { Navigation, Thumbs } from 'swiper';
import { Swiper, SwiperSlide } from 'react-id-swiper';
import 'swiper/css';
import 'swiper/css/navigation';
import 'swiper/css/thumbs';

SwiperCore.use([Navigation, Thumbs]);

function ImageGallerySwiper() {
  const [thumbsSwiper, setThumbsSwiper] = useState(null);

  const images = [
    {
      full: 'https://via.placeholder.com/800x500/007bff/ffffff?text=Image+1',
      thumb: 'https://via.placeholder.com/150x100/007bff/ffffff?text=1'
    },
    {
      full: 'https://via.placeholder.com/800x500/28a745/ffffff?text=Image+2',
      thumb: 'https://via.placeholder.com/150x100/28a745/ffffff?text=2'
    },
    {
      full: 'https://via.placeholder.com/800x500/ffc107/000000?text=Image+3',
      thumb: 'https://via.placeholder.com/150x100/ffc107/000000?text=3'
    },
    {
      full: 'https://via.placeholder.com/800x500/dc3545/ffffff?text=Image+4',
      thumb: 'https://via.placeholder.com/150x100/dc3545/ffffff?text=4'
    },
    {
      full: 'https://via.placeholder.com/800x500/6c757d/ffffff?text=Image+5',
      thumb: 'https://via.placeholder.com/150x100/6c757d/ffffff?text=5'
    }
  ];

  const mainParams = {
    spaceBetween: 10,
    navigation: {
      nextEl: '.swiper-button-next',
      prevEl: '.swiper-button-prev'
    },
    thumbs: {
      swiper: thumbsSwiper && !thumbsSwiper.destroyed ? thumbsSwiper : null
    }
  };

  const thumbsParams = {
    spaceBetween: 10,
    slidesPerView: 4,
    freeMode: true,
    watchSlidesProgress: true,
    onSwiper: setThumbsSwiper
  };

  return (
    <div style={{ padding: '20px', maxWidth: '900px', margin: '0 auto' }}>
      <h1>Image Gallery with Thumbnails</h1>
      <div style={{ marginBottom: '20px' }}>
        <Swiper {...mainParams}>
          {images.map((image, index) => (
            <SwiperSlide key={index}>
              <img
                src={image.full}
                alt={`Image ${index + 1}`}
                style={{
                  width: '100%',
                  height: '500px',
                  objectFit: 'cover',
                  borderRadius: '8px'
                }}
              />
            </SwiperSlide>
          ))}
        </Swiper>
      </div>
      <Swiper {...thumbsParams}>
        {images.map((image, index) => (
          <SwiperSlide key={index}>
            <img
              src={image.thumb}
              alt={`Thumbnail ${index + 1}`}
              style={{
                width: '100%',
                height: '100px',
                objectFit: 'cover',
                borderRadius: '4px',
                cursor: 'pointer'
              }}
            />
          </SwiperSlide>
        ))}
      </Swiper>
    </div>
  );
}

export default ImageGallerySwiper;

Now create a product carousel:

// src/ProductCarouselSwiper.jsx
import React from 'react';
import SwiperCore, { Navigation } from 'swiper';
import { Swiper, SwiperSlide } from 'react-id-swiper';
import 'swiper/css';
import 'swiper/css/navigation';

SwiperCore.use([Navigation]);

function ProductCarouselSwiper() {
  const products = [
    { id: 1, name: 'Product 1', price: '$99', image: 'https://via.placeholder.com/300x300/007bff/ffffff?text=Product+1' },
    { id: 2, name: 'Product 2', price: '$149', image: 'https://via.placeholder.com/300x300/28a745/ffffff?text=Product+2' },
    { id: 3, name: 'Product 3', price: '$199', image: 'https://via.placeholder.com/300x300/ffc107/000000?text=Product+3' },
    { id: 4, name: 'Product 4', price: '$249', image: 'https://via.placeholder.com/300x300/dc3545/ffffff?text=Product+4' },
    { id: 5, name: 'Product 5', price: '$299', image: 'https://via.placeholder.com/300x300/6c757d/ffffff?text=Product+5' }
  ];

  const params = {
    slidesPerView: 1,
    spaceBetween: 20,
    navigation: {
      nextEl: '.swiper-button-next',
      prevEl: '.swiper-button-prev'
    },
    breakpoints: {
      640: {
        slidesPerView: 2,
        spaceBetween: 20
      },
      768: {
        slidesPerView: 3,
        spaceBetween: 30
      },
      1024: {
        slidesPerView: 4,
        spaceBetween: 40
      }
    }
  };

  return (
    <div style={{ padding: '20px', maxWidth: '1200px', margin: '0 auto' }}>
      <h2>Product Carousel</h2>
      <Swiper {...params}>
        {products.map((product) => (
          <SwiperSlide key={product.id}>
            <div style={{
              padding: '15px',
              textAlign: 'center',
              backgroundColor: '#f8f9fa',
              borderRadius: '8px',
              height: '100%'
            }}>
              <img
                src={product.image}
                alt={product.name}
                style={{
                  width: '100%',
                  height: '250px',
                  objectFit: 'cover',
                  borderRadius: '4px',
                  marginBottom: '10px'
                }}
              />
              <h3 style={{ margin: '0 0 5px 0' }}>{product.name}</h3>
              <p style={{ margin: 0, fontWeight: 'bold', color: '#007bff' }}>{product.price}</p>
            </div>
          </SwiperSlide>
        ))}
      </Swiper>
    </div>
  );
}

export default ProductCarouselSwiper;

Update your App.jsx:

// src/App.jsx
import React from 'react';
import ImageGallerySwiper from './ImageGallerySwiper';
import ProductCarouselSwiper from './ProductCarouselSwiper';
import './App.css';

function App() {
  return (
    <div className="App">
      <ImageGallerySwiper />
      <ProductCarouselSwiper />
    </div>
  );
}

export default App;

This example demonstrates:

Image gallery with thumbnail navigation
Product carousel with responsive breakpoints
Touch/swipe gestures
Navigation controls
Custom styling
Multiple slides per view

Common Issues / Troubleshooting

Swiper not displaying: Make sure you've imported the CSS files. Also check that SwiperCore modules are properly initialized with SwiperCore.use().
Navigation not working: Ensure navigation selectors (.swiper-button-next, .swiper-button-prev) are correctly configured in params. The elements are created automatically by Swiper.
Thumbnails not syncing: For thumbnail galleries, make sure the thumbs param is set correctly and the thumbs swiper is passed to the main swiper.
Touch gestures not working: Touch support is enabled by default. If gestures aren't working, check for CSS conflicts or ensure the swiper container has proper dimensions.
Responsive breakpoints: Use the breakpoints object in params to configure different settings for different screen sizes. The breakpoint values are in pixels.
Autoplay not working: Make sure the Autoplay module is imported and used with SwiperCore.use([Autoplay]). Also check that autoplay params are correctly configured.

Next Steps

Now that you have an understanding of react-id-swiper:

Explore all available Swiper modules
Learn about advanced configuration options
Implement lazy loading for images
Add custom animations and transitions
Create vertical sliders
Integrate with React Router for navigation
Learn about other slider libraries (swiper, react-slick)
Check the official repository: https://github.com/kidjp85/react-id-swiper
Look for part 60 of this series for more advanced topics

Summary

You've successfully integrated react-id-swiper into your React application and created touch-enabled sliders with navigation, thumbnails, and responsive breakpoints. react-id-swiper provides a React-friendly wrapper for Swiper.js with full feature support.

SEO Keywords

react-id-swiper
React Swiper wrapper
react-id-swiper tutorial
React touch slider
react-id-swiper installation
React Swiper.js
react-id-swiper example
React carousel slider
react-id-swiper setup
React image gallery
react-id-swiper customization
React swipe gestures
react-id-swiper navigation
React slider library
react-id-swiper getting started

Getting Started with Pure React Carousel: Building Image Carousels

Joseph Nelson — Mon, 19 Jan 2026 17:19:55 +0000

Pure React Carousel is a lightweight, flexible carousel component library for React applications. It provides a simple API for creating image carousels, content sliders, and navigation components with minimal configuration. This guide walks through setting up and creating carousels using Pure React Carousel with React, from installation to a working implementation. This is part 58 of a series on using Pure React Carousel with React.

Prerequisites

Before you begin, make sure you have:

Node.js version 14.0 or higher installed
npm, yarn, or pnpm package manager
A React project (version 16.8 or higher) or create-react-app setup
Basic knowledge of React components
Familiarity with JavaScript/TypeScript

Installation

Install Pure React Carousel using your preferred package manager:

npm install pure-react-carousel

Or with yarn:

yarn add pure-react-carousel

Or with pnpm:

pnpm add pure-react-carousel

After installation, your package.json should include:

{
  "dependencies": {
    "pure-react-carousel": "^1.29.0",
    "react": "^18.0.0",
    "react-dom": "^18.0.0"
  }
}

Project Setup

Pure React Carousel requires minimal setup. Import the components and you're ready to use them.

First Example / Basic Usage

Let's create a simple image carousel. Create a new file src/CarouselExample.jsx:

// src/CarouselExample.jsx
import React from 'react';
import {
  CarouselProvider,
  Slider,
  Slide,
  ButtonBack,
  ButtonNext
} from 'pure-react-carousel';
import 'pure-react-carousel/dist/react-carousel.es.css';

function CarouselExample() {
  const images = [
    'https://via.placeholder.com/800x400/007bff/ffffff?text=Slide+1',
    'https://via.placeholder.com/800x400/28a745/ffffff?text=Slide+2',
    'https://via.placeholder.com/800x400/ffc107/000000?text=Slide+3',
    'https://via.placeholder.com/800x400/dc3545/ffffff?text=Slide+4'
  ];

  return (
    <div style={{ padding: '20px', maxWidth: '800px', margin: '0 auto' }}>
      <h2>Basic Carousel Example</h2>
      <CarouselProvider
        naturalSlideWidth={100}
        naturalSlideHeight={50}
        totalSlides={images.length}
      >
        <Slider>
          {images.map((image, index) => (
            <Slide key={index} index={index}>
              <img
                src={image}
                alt={`Slide ${index + 1}`}
                style={{ width: '100%', height: '100%', objectFit: 'cover' }}
              />
            </Slide>
          ))}
        </Slider>
        <ButtonBack style={{
          position: 'absolute',
          left: '10px',
          top: '50%',
          transform: 'translateY(-50%)',
          padding: '10px 15px',
          backgroundColor: 'rgba(0,0,0,0.5)',
          color: 'white',
          border: 'none',
          borderRadius: '4px',
          cursor: 'pointer',
          zIndex: 1
        }}>
          ‹
        </ButtonBack>
        <ButtonNext style={{
          position: 'absolute',
          right: '10px',
          top: '50%',
          transform: 'translateY(-50%)',
          padding: '10px 15px',
          backgroundColor: 'rgba(0,0,0,0.5)',
          color: 'white',
          border: 'none',
          borderRadius: '4px',
          cursor: 'pointer',
          zIndex: 1
        }}>
          ›
        </ButtonNext>
      </CarouselProvider>
    </div>
  );
}

export default CarouselExample;

Update your App.jsx:

// src/App.jsx
import React from 'react';
import CarouselExample from './CarouselExample';
import './App.css';

function App() {
  return (
    <div className="App">
      <CarouselExample />
    </div>
  );
}

export default App;

This creates a basic image carousel with navigation buttons.

Understanding the Basics

Pure React Carousel uses a component-based structure:

CarouselProvider: Main container that manages carousel state
Slider: Container for slides
Slide: Individual slide component
ButtonBack/ButtonNext: Navigation buttons
DotGroup: Navigation dots
Image: Optimized image component

Key concepts:

naturalSlideWidth/Height: Aspect ratio of slides (used for responsive sizing)
totalSlides: Total number of slides
Slide index: Each slide needs a unique index starting from 0
Responsive: Automatically adjusts to container size
Styling: Import CSS file for default styles

Here's an example with dots and custom styling:

// src/AdvancedCarouselExample.jsx
import React from 'react';
import {
  CarouselProvider,
  Slider,
  Slide,
  ButtonBack,
  ButtonNext,
  DotGroup
} from 'pure-react-carousel';
import 'pure-react-carousel/dist/react-carousel.es.css';

function AdvancedCarouselExample() {
  const images = [
    'https://via.placeholder.com/800x400/007bff/ffffff?text=Slide+1',
    'https://via.placeholder.com/800x400/28a745/ffffff?text=Slide+2',
    'https://via.placeholder.com/800x400/ffc107/000000?text=Slide+3',
    'https://via.placeholder.com/800x400/dc3545/ffffff?text=Slide+4'
  ];

  return (
    <div style={{ padding: '20px', maxWidth: '800px', margin: '0 auto' }}>
      <h2>Advanced Carousel with Dots</h2>
      <CarouselProvider
        naturalSlideWidth={100}
        naturalSlideHeight={50}
        totalSlides={images.length}
        isPlaying={true}
        interval={3000}
      >
        <div style={{ position: 'relative' }}>
          <Slider>
            {images.map((image, index) => (
              <Slide key={index} index={index}>
                <img
                  src={image}
                  alt={`Slide ${index + 1}`}
                  style={{ width: '100%', height: '100%', objectFit: 'cover' }}
                />
              </Slide>
            ))}
          </Slider>
          <ButtonBack style={{
            position: 'absolute',
            left: '10px',
            top: '50%',
            transform: 'translateY(-50%)',
            padding: '10px 15px',
            backgroundColor: 'rgba(255,255,255,0.8)',
            color: '#333',
            border: 'none',
            borderRadius: '50%',
            cursor: 'pointer',
            zIndex: 1,
            fontSize: '20px',
            width: '40px',
            height: '40px',
            display: 'flex',
            alignItems: 'center',
            justifyContent: 'center'
          }}>
            ‹
          </ButtonBack>
          <ButtonNext style={{
            position: 'absolute',
            right: '10px',
            top: '50%',
            transform: 'translateY(-50%)',
            padding: '10px 15px',
            backgroundColor: 'rgba(255,255,255,0.8)',
            color: '#333',
            border: 'none',
            borderRadius: '50%',
            cursor: 'pointer',
            zIndex: 1,
            fontSize: '20px',
            width: '40px',
            height: '40px',
            display: 'flex',
            alignItems: 'center',
            justifyContent: 'center'
          }}>
            ›
          </ButtonNext>
        </div>
        <DotGroup style={{
          display: 'flex',
          justifyContent: 'center',
          gap: '10px',
          marginTop: '20px'
        }} />
      </CarouselProvider>
    </div>
  );
}

export default AdvancedCarouselExample;

Practical Example / Building Something Real

Let's build a complete image gallery carousel:

// src/ImageGalleryCarousel.jsx
import React, { useState } from 'react';
import {
  CarouselProvider,
  Slider,
  Slide,
  ButtonBack,
  ButtonNext,
  DotGroup
} from 'pure-react-carousel';
import 'pure-react-carousel/dist/react-carousel.es.css';

function ImageGalleryCarousel() {
  const [currentSlide, setCurrentSlide] = useState(0);

  const images = [
    {
      src: 'https://via.placeholder.com/800x500/007bff/ffffff?text=Image+1',
      title: 'Image 1',
      description: 'Description for image 1'
    },
    {
      src: 'https://via.placeholder.com/800x500/28a745/ffffff?text=Image+2',
      title: 'Image 2',
      description: 'Description for image 2'
    },
    {
      src: 'https://via.placeholder.com/800x500/ffc107/000000?text=Image+3',
      title: 'Image 3',
      description: 'Description for image 3'
    },
    {
      src: 'https://via.placeholder.com/800x500/dc3545/ffffff?text=Image+4',
      title: 'Image 4',
      description: 'Description for image 4'
    },
    {
      src: 'https://via.placeholder.com/800x500/6c757d/ffffff?text=Image+5',
      title: 'Image 5',
      description: 'Description for image 5'
    }
  ];

  return (
    <div style={{ padding: '20px', maxWidth: '900px', margin: '0 auto' }}>
      <h1>Image Gallery Carousel</h1>
      <CarouselProvider
        naturalSlideWidth={100}
        naturalSlideHeight={62.5}
        totalSlides={images.length}
        currentSlide={currentSlide}
      >
        <div style={{ position: 'relative', marginBottom: '20px' }}>
          <Slider>
            {images.map((image, index) => (
              <Slide key={index} index={index}>
                <div style={{ position: 'relative', width: '100%', height: '100%' }}>
                  <img
                    src={image.src}
                    alt={image.title}
                    style={{
                      width: '100%',
                      height: '100%',
                      objectFit: 'cover',
                      display: 'block'
                    }}
                  />
                  <div style={{
                    position: 'absolute',
                    bottom: 0,
                    left: 0,
                    right: 0,
                    background: 'linear-gradient(to top, rgba(0,0,0,0.7), transparent)',
                    color: 'white',
                    padding: '20px'
                  }}>
                    <h3 style={{ margin: '0 0 5px 0' }}>{image.title}</h3>
                    <p style={{ margin: 0 }}>{image.description}</p>
                  </div>
                </div>
              </Slide>
            ))}
          </Slider>
          <ButtonBack style={{
            position: 'absolute',
            left: '10px',
            top: '50%',
            transform: 'translateY(-50%)',
            padding: '10px 15px',
            backgroundColor: 'rgba(255,255,255,0.9)',
            color: '#333',
            border: 'none',
            borderRadius: '50%',
            cursor: 'pointer',
            zIndex: 1,
            fontSize: '24px',
            width: '50px',
            height: '50px',
            display: 'flex',
            alignItems: 'center',
            justifyContent: 'center',
            boxShadow: '0 2px 4px rgba(0,0,0,0.2)'
          }}>
            ‹
          </ButtonBack>
          <ButtonNext style={{
            position: 'absolute',
            right: '10px',
            top: '50%',
            transform: 'translateY(-50%)',
            padding: '10px 15px',
            backgroundColor: 'rgba(255,255,255,0.9)',
            color: '#333',
            border: 'none',
            borderRadius: '50%',
            cursor: 'pointer',
            zIndex: 1,
            fontSize: '24px',
            width: '50px',
            height: '50px',
            display: 'flex',
            alignItems: 'center',
            justifyContent: 'center',
            boxShadow: '0 2px 4px rgba(0,0,0,0.2)'
          }}>
            ›
          </ButtonNext>
        </div>
        <DotGroup
          style={{
            display: 'flex',
            justifyContent: 'center',
            gap: '10px',
            marginTop: '20px'
          }}
        />
      </CarouselProvider>
      <div style={{ textAlign: 'center', marginTop: '20px', color: '#666' }}>
        Slide {currentSlide + 1} of {images.length}
      </div>
    </div>
  );
}

export default ImageGalleryCarousel;

Now create a product carousel:

// src/ProductCarousel.jsx
import React from 'react';
import {
  CarouselProvider,
  Slider,
  Slide,
  ButtonBack,
  ButtonNext
} from 'pure-react-carousel';
import 'pure-react-carousel/dist/react-carousel.es.css';

function ProductCarousel() {
  const products = [
    { id: 1, name: 'Product 1', price: '$99', image: 'https://via.placeholder.com/300x300/007bff/ffffff?text=Product+1' },
    { id: 2, name: 'Product 2', price: '$149', image: 'https://via.placeholder.com/300x300/28a745/ffffff?text=Product+2' },
    { id: 3, name: 'Product 3', price: '$199', image: 'https://via.placeholder.com/300x300/ffc107/000000?text=Product+3' },
    { id: 4, name: 'Product 4', price: '$249', image: 'https://via.placeholder.com/300x300/dc3545/ffffff?text=Product+4' }
  ];

  return (
    <div style={{ padding: '20px', maxWidth: '1200px', margin: '0 auto' }}>
      <h2>Product Carousel</h2>
      <CarouselProvider
        naturalSlideWidth={100}
        naturalSlideHeight={100}
        totalSlides={products.length}
        visibleSlides={3}
        step={1}
        dragEnabled={true}
      >
        <div style={{ position: 'relative' }}>
          <Slider>
            {products.map((product, index) => (
              <Slide key={product.id} index={index}>
                <div style={{
                  padding: '10px',
                  textAlign: 'center'
                }}>
                  <img
                    src={product.image}
                    alt={product.name}
                    style={{
                      width: '100%',
                      height: '250px',
                      objectFit: 'cover',
                      borderRadius: '8px',
                      marginBottom: '10px'
                    }}
                  />
                  <h3 style={{ margin: '0 0 5px 0' }}>{product.name}</h3>
                  <p style={{ margin: 0, fontWeight: 'bold', color: '#007bff' }}>{product.price}</p>
                </div>
              </Slide>
            ))}
          </Slider>
          <ButtonBack style={{
            position: 'absolute',
            left: '-50px',
            top: '50%',
            transform: 'translateY(-50%)',
            padding: '10px 15px',
            backgroundColor: '#007bff',
            color: 'white',
            border: 'none',
            borderRadius: '4px',
            cursor: 'pointer',
            zIndex: 1
          }}>
            ‹
          </ButtonBack>
          <ButtonNext style={{
            position: 'absolute',
            right: '-50px',
            top: '50%',
            transform: 'translateY(-50%)',
            padding: '10px 15px',
            backgroundColor: '#007bff',
            color: 'white',
            border: 'none',
            borderRadius: '4px',
            cursor: 'pointer',
            zIndex: 1
          }}>
            ›
          </ButtonNext>
        </div>
      </CarouselProvider>
    </div>
  );
}

export default ProductCarousel;

Update your App.jsx:

// src/App.jsx
import React from 'react';
import ImageGalleryCarousel from './ImageGalleryCarousel';
import ProductCarousel from './ProductCarousel';
import './App.css';

function App() {
  return (
    <div className="App">
      <ImageGalleryCarousel />
      <ProductCarousel />
    </div>
  );
}

export default App;

This example demonstrates:

Image gallery carousel with navigation
Product carousel with multiple visible slides
Custom navigation buttons
Dot indicators
Responsive design
Drag support

Common Issues / Troubleshooting

Carousel not displaying: Make sure you've imported the CSS file (import 'pure-react-carousel/dist/react-carousel.es.css'). Also check that naturalSlideWidth and naturalSlideHeight are set correctly.
Slides not showing: Ensure each Slide component has a unique index prop starting from 0. The totalSlides prop should match the number of slides.
Aspect ratio issues: Use naturalSlideWidth and naturalSlideHeight to define the aspect ratio. For example, naturalSlideWidth={100} and naturalSlideHeight={50} creates a 2:1 aspect ratio.
Navigation not working: Make sure ButtonBack and ButtonNext are inside the CarouselProvider. They need to be within the provider context to work.
Multiple slides visible: Use the visibleSlides prop to show multiple slides at once. This is useful for product carousels.
Drag not working: Enable drag by setting dragEnabled={true} on the CarouselProvider. This allows users to swipe/drag slides.

Next Steps

Now that you have a basic understanding of Pure React Carousel:

Learn about advanced carousel configurations
Explore autoplay and interval settings
Implement thumbnail navigation
Add touch gesture support
Create custom slide transitions
Learn about other carousel libraries (react-slick, swiper)
Check the official repository: https://github.com/express-labs/pure-react-carousel
Look for part 59 of this series for more advanced topics

Summary

You've successfully set up Pure React Carousel in your React application and created image galleries and product carousels with navigation controls. Pure React Carousel provides a simple, flexible solution for creating carousels with minimal configuration.

SEO Keywords

pure-react-carousel
React carousel component
pure-react-carousel tutorial
React image carousel
pure-react-carousel installation
React slider component
pure-react-carousel example
React carousel library
pure-react-carousel setup
React image gallery
pure-react-carousel customization
React carousel navigation
pure-react-carousel dots
React carousel slider
pure-react-carousel getting started

Advanced Image Sliders with react-awesome-slider in React

Joseph Nelson — Mon, 19 Jan 2026 17:16:24 +0000

react-awesome-slider is a full-featured, performant slider component for React applications. It provides smooth animations, touch gestures, keyboard navigation, and extensive customization options for creating professional image galleries and content sliders. This guide walks through advanced usage of react-awesome-slider with React, including custom animations, autoplay, and complex slider configurations. This is part 57 of a series on using react-awesome-slider with React.

Prerequisites

Before you begin, make sure you have:

Node.js version 14.0 or higher installed
npm, yarn, or pnpm package manager
A React project (version 16.8 or higher) or create-react-app setup
Basic knowledge of React hooks (useState, useEffect, useRef)
Familiarity with CSS animations
Understanding of touch events and gestures

Installation

Install react-awesome-slider and required CSS:

npm install react-awesome-slider core-js

Or with yarn:

yarn add react-awesome-slider core-js

Or with pnpm:

pnpm add react-awesome-slider core-js

After installation, your package.json should include:

{
  "dependencies": {
    "react-awesome-slider": "^4.1.0",
    "core-js": "^3.0.0",
    "react": "^18.0.0",
    "react-dom": "^18.0.0"
  }
}

Project Setup

Import the CSS file in your main entry file:

// src/index.js
import React from 'react';
import ReactDOM from 'react-dom/client';
import 'react-awesome-slider/dist/styles.css';
import App from './App';

const root = ReactDOM.createRoot(document.getElementById('root'));
root.render(
  <React.StrictMode>
    <App />
  </React.StrictMode>
);

First Example / Basic Usage

Let's create a simple image slider. Create a new file src/SliderExample.jsx:

// src/SliderExample.jsx
import React from 'react';
import AwesomeSlider from 'react-awesome-slider';
import 'react-awesome-slider/dist/styles.css';

function SliderExample() {
  const images = [
    'https://via.placeholder.com/800x400/007bff/ffffff?text=Slide+1',
    'https://via.placeholder.com/800x400/28a745/ffffff?text=Slide+2',
    'https://via.placeholder.com/800x400/ffc107/000000?text=Slide+3',
    'https://via.placeholder.com/800x400/dc3545/ffffff?text=Slide+4'
  ];

  return (
    <div style={{ padding: '20px', maxWidth: '800px', margin: '0 auto' }}>
      <h2>Basic Slider Example</h2>
      <AwesomeSlider>
        {images.map((image, index) => (
          <div key={index} data-src={image} />
        ))}
      </AwesomeSlider>
    </div>
  );
}

export default SliderExample;

Update your App.jsx:

// src/App.jsx
import React from 'react';
import SliderExample from './SliderExample';
import './App.css';

function App() {
  return (
    <div className="App">
      <SliderExample />
    </div>
  );
}

export default App;

This creates a basic image slider with navigation and touch support.

Understanding the Basics

react-awesome-slider provides several key features:

AwesomeSlider component: Main slider component
Animation styles: Multiple animation presets (foldOutAnimation, scaleOutAnimation, etc.)
Autoplay: Automatic slide progression
Touch gestures: Swipe support for mobile
Keyboard navigation: Arrow key support
Custom bullets: Customizable navigation dots
Media support: Images, videos, and custom content

Key concepts for advanced usage:

Animation: Choose from preset animations or create custom ones
Media sources: Use data-src attribute for images
Custom content: Add any React components as slides
Event handlers: Use onTransitionStart, onTransitionEnd callbacks
Controlled mode: Control slider programmatically with refs

Here's an example with custom animations and autoplay:

// src/AdvancedSliderExample.jsx
import React from 'react';
import AwesomeSlider from 'react-awesome-slider';
import withAutoplay from 'react-awesome-slider/dist/autoplay';
import 'react-awesome-slider/dist/styles.css';

const AutoplaySlider = withAutoplay(AwesomeSlider);

function AdvancedSliderExample() {
  const images = [
    'https://via.placeholder.com/800x400/007bff/ffffff?text=Slide+1',
    'https://via.placeholder.com/800x400/28a745/ffffff?text=Slide+2',
    'https://via.placeholder.com/800x400/ffc107/000000?text=Slide+3',
    'https://via.placeholder.com/800x400/dc3545/ffffff?text=Slide+4'
  ];

  return (
    <div style={{ padding: '20px', maxWidth: '800px', margin: '0 auto' }}>
      <h2>Advanced Slider with Autoplay</h2>
      <AutoplaySlider
        play={true}
        cancelOnInteraction={false}
        interval={3000}
        animation="foldOutAnimation"
      >
        {images.map((image, index) => (
          <div key={index} data-src={image} />
        ))}
      </AutoplaySlider>
    </div>
  );
}

export default AdvancedSliderExample;

Practical Example / Building Something Real

Let's build a comprehensive image gallery with custom controls and transitions:

// src/ImageGallerySlider.jsx
import React, { useState, useRef } from 'react';
import AwesomeSlider from 'react-awesome-slider';
import withAutoplay from 'react-awesome-slider/dist/autoplay';
import 'react-awesome-slider/dist/styles.css';

const AutoplaySlider = withAutoplay(AwesomeSlider);

function ImageGallerySlider() {
  const sliderRef = useRef(null);
  const [currentSlide, setCurrentSlide] = useState(0);
  const [isPlaying, setIsPlaying] = useState(false);

  const images = [
    {
      src: 'https://via.placeholder.com/800x500/007bff/ffffff?text=Image+1',
      title: 'Image 1',
      description: 'Description for image 1'
    },
    {
      src: 'https://via.placeholder.com/800x500/28a745/ffffff?text=Image+2',
      title: 'Image 2',
      description: 'Description for image 2'
    },
    {
      src: 'https://via.placeholder.com/800x500/ffc107/000000?text=Image+3',
      title: 'Image 3',
      description: 'Description for image 3'
    },
    {
      src: 'https://via.placeholder.com/800x500/dc3545/ffffff?text=Image+4',
      title: 'Image 4',
      description: 'Description for image 4'
    },
    {
      src: 'https://via.placeholder.com/800x500/6c757d/ffffff?text=Image+5',
      title: 'Image 5',
      description: 'Description for image 5'
    }
  ];

  const handleNext = () => {
    sliderRef.current?.next();
  };

  const handlePrev = () => {
    sliderRef.current?.prev();
  };

  const handleGoToSlide = (index) => {
    sliderRef.current?.goto(index);
  };

  const handleTransitionStart = (entry) => {
    setCurrentSlide(entry.index);
  };

  return (
    <div style={{ padding: '20px', maxWidth: '900px', margin: '0 auto' }}>
      <h1>Image Gallery Slider</h1>

      <div style={{ position: 'relative', marginBottom: '20px' }}>
        <AutoplaySlider
          ref={sliderRef}
          play={isPlaying}
          cancelOnInteraction={true}
          interval={4000}
          animation="foldOutAnimation"
          onTransitionStart={handleTransitionStart}
          bullets={false}
          organicArrows={true}
        >
          {images.map((image, index) => (
            <div key={index} data-src={image.src}>
              <div style={{
                position: 'absolute',
                bottom: 0,
                left: 0,
                right: 0,
                background: 'linear-gradient(to top, rgba(0,0,0,0.7), transparent)',
                color: 'white',
                padding: '20px'
              }}>
                <h3 style={{ margin: '0 0 5px 0' }}>{image.title}</h3>
                <p style={{ margin: 0 }}>{image.description}</p>
              </div>
            </div>
          ))}
        </AutoplaySlider>
      </div>

      <div style={{ display: 'flex', justifyContent: 'center', alignItems: 'center', gap: '10px', marginBottom: '20px' }}>
        <button
          onClick={handlePrev}
          style={{
            padding: '10px 20px',
            backgroundColor: '#007bff',
            color: 'white',
            border: 'none',
            borderRadius: '4px',
            cursor: 'pointer'
          }}
        >
          Previous
        </button>
        <button
          onClick={() => setIsPlaying(!isPlaying)}
          style={{
            padding: '10px 20px',
            backgroundColor: isPlaying ? '#dc3545' : '#28a745',
            color: 'white',
            border: 'none',
            borderRadius: '4px',
            cursor: 'pointer'
          }}
        >
          {isPlaying ? 'Pause' : 'Play'}
        </button>
        <button
          onClick={handleNext}
          style={{
            padding: '10px 20px',
            backgroundColor: '#007bff',
            color: 'white',
            border: 'none',
            borderRadius: '4px',
            cursor: 'pointer'
          }}
        >
          Next
        </button>
      </div>

      <div style={{ display: 'flex', justifyContent: 'center', gap: '10px' }}>
        {images.map((_, index) => (
          <button
            key={index}
            onClick={() => handleGoToSlide(index)}
            style={{
              width: '12px',
              height: '12px',
              borderRadius: '50%',
              border: 'none',
              backgroundColor: currentSlide === index ? '#007bff' : '#ccc',
              cursor: 'pointer',
              transition: 'background-color 0.3s'
            }}
            aria-label={`Go to slide ${index + 1}`}
          />
        ))}
      </div>

      <div style={{ marginTop: '20px', textAlign: 'center', color: '#666' }}>
        Slide {currentSlide + 1} of {images.length}
      </div>
    </div>
  );
}

export default ImageGallerySlider;

Now create a video slider:

// src/VideoSlider.jsx
import React from 'react';
import AwesomeSlider from 'react-awesome-slider';
import 'react-awesome-slider/dist/styles.css';

function VideoSlider() {
  const media = [
    {
      type: 'image',
      src: 'https://via.placeholder.com/800x450/007bff/ffffff?text=Image+1'
    },
    {
      type: 'video',
      src: 'https://www.w3schools.com/html/mov_bbb.mp4'
    },
    {
      type: 'image',
      src: 'https://via.placeholder.com/800x450/28a745/ffffff?text=Image+2'
    }
  ];

  return (
    <div style={{ padding: '20px', maxWidth: '800px', margin: '0 auto' }}>
      <h2>Mixed Media Slider</h2>
      <AwesomeSlider animation="scaleOutAnimation">
        {media.map((item, index) => (
          <div key={index} data-src={item.src}>
            {item.type === 'video' && (
              <video
                src={item.src}
                autoPlay
                loop
                muted
                style={{ width: '100%', height: '100%', objectFit: 'cover' }}
              />
            )}
          </div>
        ))}
      </AwesomeSlider>
    </div>
  );
}

export default VideoSlider;

Update your App.jsx:

// src/App.jsx
import React from 'react';
import ImageGallerySlider from './ImageGallerySlider';
import VideoSlider from './VideoSlider';
import './App.css';

function App() {
  return (
    <div className="App">
      <ImageGallerySlider />
      <VideoSlider />
    </div>
  );
}

export default App;

This example demonstrates:

Image gallery with custom controls
Autoplay functionality
Programmatic navigation
Custom bullets
Slide transitions
Mixed media support
Event handling

Common Issues / Troubleshooting

Slider not displaying: Make sure you've imported the CSS file (import 'react-awesome-slider/dist/styles.css'). The slider requires styles to render correctly.
Images not loading: Use the data-src attribute for images. Ensure image URLs are accessible and valid.
Autoplay not working: Import and use the withAutoplay HOC. Make sure play prop is set to true and interval is specified.
Navigation not working: Check that you're using the ref correctly. The slider methods (next(), prev(), goto()) are available on the ref.
Animations not smooth: Ensure you're using valid animation names. Common animations include foldOutAnimation, scaleOutAnimation, cubeAnimation.
Touch gestures not working: The slider includes touch support by default. If gestures aren't working, check for CSS conflicts or z-index issues.

Next Steps

Now that you have an advanced understanding of react-awesome-slider:

Explore all available animation styles
Learn about custom animations and transitions
Implement lazy loading for images
Add thumbnail navigation
Create fullscreen gallery mode
Integrate with image optimization libraries
Learn about other slider libraries (swiper, react-slick)
Check the official repository: https://github.com/rcaferati/react-awesome-slider
Look for part 58 of this series for more advanced topics

Summary

You've successfully integrated react-awesome-slider into your React application with advanced features including autoplay, custom controls, programmatic navigation, and mixed media support. react-awesome-slider provides a powerful, performant solution for creating professional image galleries and content sliders.

SEO Keywords

react-awesome-slider
React image slider
react-awesome-slider tutorial
React carousel component
react-awesome-slider installation
React slider gallery
react-awesome-slider example
React image gallery
react-awesome-slider setup
React autoplay slider
react-awesome-slider customization
React slider animations
react-awesome-slider controls
React slider library
react-awesome-slider getting started

Building CAPTCHA Protection with ProCaptcha in React

Joseph Nelson — Mon, 19 Jan 2026 17:14:17 +0000

roCaptcha is a privacy-preserving CAPTCHA library for React applications. It provides a decentralized approach to bot protection while maintaining user privacy. This guide walks through setting up and creating CAPTCHA protection using ProCaptcha with React, from installation to a working implementation. This is part 56 of a series on using ProCaptcha with React.

Prerequisites

CAPTCHA Types

Before you begin, make sure you have:

Node.js version 14.0 or higher installed
npm, yarn, or pnpm package manager
A React project (version 16.8 or higher) or create-react-app setup
Basic knowledge of React hooks (useState, useEffect)
Familiarity with JavaScript/TypeScript
Understanding of async operations

Installation

Install ProCaptcha using your preferred package manager:

npm install @prosopo/captcha

Or with yarn:

yarn add @prosopo/captcha

Or with pnpm:

pnpm add @prosopo/captcha

After installation, your package.json should include:

{
  "dependencies": {
    "@prosopo/captcha": "^1.0.0",
    "react": "^18.0.0",
    "react-dom": "^18.0.0"
  }
}

Project Setup

ProCaptcha requires configuration. Set up the provider and component:

// src/index.js
import React from 'react';
import ReactDOM from 'react-dom/client';
import { ProsopoProvider } from '@prosopo/captcha';
import App from './App';

const root = ReactDOM.createRoot(document.getElementById('root'));
root.render(
  <React.StrictMode>
    <ProsopoProvider
      config={{
        dappName: 'MyApp',
        networkId: 'development'
      }}
    >
      <App />
    </ProsopoProvider>
  </React.StrictMode>
);

First Example / Basic Usage

Let's create a simple CAPTCHA form. Create a new file src/CaptchaExample.jsx:

// src/CaptchaExample.jsx
import React, { useState } from 'react';
import { useProsopo } from '@prosopo/captcha';

function CaptchaExample() {
  const { captcha, verify } = useProsopo();
  const [isVerified, setIsVerified] = useState(false);
  const [isLoading, setIsLoading] = useState(false);

  const handleVerify = async () => {
    setIsLoading(true);
    try {
      const result = await captcha.verify();
      setIsVerified(result);
      if (result) {
        alert('CAPTCHA verified successfully!');
      } else {
        alert('CAPTCHA verification failed. Please try again.');
      }
    } catch (error) {
      console.error('CAPTCHA error:', error);
      alert('Error verifying CAPTCHA. Please try again.');
    } finally {
      setIsLoading(false);
    }
  };

  return (
    <div style={{ padding: '20px', maxWidth: '400px', margin: '0 auto' }}>
      <h2>ProCaptcha Example</h2>
      <div style={{ marginBottom: '20px', padding: '20px', border: '1px solid #ddd', borderRadius: '8px' }}>
        {captcha && (
          <div>
            <p>Complete the CAPTCHA challenge below:</p>
            <div style={{ marginTop: '15px' }}>
              {captcha.render()}
            </div>
          </div>
        )}
      </div>
      <button
        onClick={handleVerify}
        disabled={isLoading}
        style={{
          padding: '10px 20px',
          backgroundColor: isLoading ? '#6c757d' : '#007bff',
          color: 'white',
          border: 'none',
          borderRadius: '4px',
          cursor: isLoading ? 'not-allowed' : 'pointer',
          width: '100%'
        }}
      >
        {isLoading ? 'Verifying...' : 'Verify CAPTCHA'}
      </button>
      {isVerified && (
        <p style={{ color: 'green', marginTop: '10px', textAlign: 'center' }}>
          ✓ CAPTCHA verified successfully!
        </p>
      )}
    </div>
  );
}

export default CaptchaExample;

Update your App.jsx:

// src/App.jsx
import React from 'react';
import CaptchaExample from './CaptchaExample';
import './App.css';

function App() {
  return (
    <div className="App">
      <CaptchaExample />
    </div>
  );
}

export default App;

This creates a basic CAPTCHA form that verifies user interaction.

Understanding the Basics

ProCaptcha provides several key features:

ProsopoProvider: Context provider for CAPTCHA functionality
useProsopo hook: Access CAPTCHA methods and state
Privacy-preserving: Decentralized approach to bot protection
Verification: Async verification process
Customizable: Configurable for different networks and dapps

Key concepts:

Provider Setup: Wrap your app with ProsopoProvider
Hook Usage: Use useProsopo hook to access CAPTCHA
Verification: Call captcha.verify() to verify user interaction
State Management: Track verification state in your component
Error Handling: Handle verification errors gracefully

Here's an example with form integration:

// src/FormWithCaptcha.jsx
import React, { useState } from 'react';
import { useProsopo } from '@prosopo/captcha';

function FormWithCaptcha() {
  const { captcha, verify } = useProsopo();
  const [formData, setFormData] = useState({
    email: '',
    message: ''
  });
  const [isVerified, setIsVerified] = useState(false);
  const [isSubmitting, setIsSubmitting] = useState(false);

  const handleInputChange = (e) => {
    const { name, value } = e.target;
    setFormData(prev => ({ ...prev, [name]: value }));
  };

  const handleVerify = async () => {
    try {
      const result = await verify();
      setIsVerified(result);
    } catch (error) {
      console.error('Verification error:', error);
    }
  };

  const handleSubmit = async (e) => {
    e.preventDefault();
    if (!isVerified) {
      alert('Please complete the CAPTCHA first.');
      return;
    }
    setIsSubmitting(true);
    // Simulate form submission
    await new Promise(resolve => setTimeout(resolve, 1000));
    alert('Form submitted successfully!');
    setIsSubmitting(false);
  };

  return (
    <div style={{ padding: '20px', maxWidth: '500px', margin: '0 auto' }}>
      <h2>Form with ProCaptcha</h2>
      <form onSubmit={handleSubmit}>
        <div style={{ marginBottom: '16px' }}>
          <label style={{ display: 'block', marginBottom: '4px' }}>
            Email:
          </label>
          <input
            type="email"
            name="email"
            value={formData.email}
            onChange={handleInputChange}
            required
            style={{
              width: '100%',
              padding: '8px',
              border: '1px solid #ddd',
              borderRadius: '4px',
              boxSizing: 'border-box'
            }}
          />
        </div>
        <div style={{ marginBottom: '16px' }}>
          <label style={{ display: 'block', marginBottom: '4px' }}>
            Message:
          </label>
          <textarea
            name="message"
            value={formData.message}
            onChange={handleInputChange}
            required
            rows={4}
            style={{
              width: '100%',
              padding: '8px',
              border: '1px solid #ddd',
              borderRadius: '4px',
              boxSizing: 'border-box',
              resize: 'vertical'
            }}
          />
        </div>
        <div style={{ marginBottom: '20px', padding: '15px', border: '1px solid #ddd', borderRadius: '4px', backgroundColor: '#f8f9fa' }}>
          <label style={{ display: 'block', marginBottom: '10px' }}>
            CAPTCHA Verification:
          </label>
          {captcha && (
            <div style={{ marginBottom: '10px' }}>
              {captcha.render()}
            </div>
          )}
          <button
            type="button"
            onClick={handleVerify}
            style={{
              padding: '8px 16px',
              backgroundColor: '#28a745',
              color: 'white',
              border: 'none',
              borderRadius: '4px',
              cursor: 'pointer'
            }}
          >
            Verify CAPTCHA
          </button>
          {isVerified && (
            <p style={{ color: 'green', marginTop: '10px' }}>
              ✓ Verified
            </p>
          )}
        </div>
        <button
          type="submit"
          disabled={!isVerified || isSubmitting}
          style={{
            padding: '10px 20px',
            backgroundColor: (!isVerified || isSubmitting) ? '#6c757d' : '#007bff',
            color: 'white',
            border: 'none',
            borderRadius: '4px',
            cursor: (!isVerified || isSubmitting) ? 'not-allowed' : 'pointer',
            width: '100%'
          }}
        >
          {isSubmitting ? 'Submitting...' : 'Submit'}
        </button>
      </form>
    </div>
  );
}

export default FormWithCaptcha;

Practical Example / Building Something Real

Let's build a complete contact form with ProCaptcha protection:

// src/ContactFormWithProCaptcha.jsx
import React, { useState } from 'react';
import { useProsopo } from '@prosopo/captcha';

function ContactFormWithProCaptcha() {
  const { captcha, verify } = useProsopo();
  const [formData, setFormData] = useState({
    name: '',
    email: '',
    subject: '',
    message: ''
  });
  const [isVerified, setIsVerified] = useState(false);
  const [isVerifying, setIsVerifying] = useState(false);
  const [isSubmitting, setIsSubmitting] = useState(false);
  const [error, setError] = useState('');

  const handleInputChange = (e) => {
    const { name, value } = e.target;
    setFormData(prev => ({ ...prev, [name]: value }));
    setError('');
  };

  const handleVerify = async () => {
    setIsVerifying(true);
    setError('');
    try {
      const result = await verify();
      setIsVerified(result);
      if (!result) {
        setError('CAPTCHA verification failed. Please try again.');
      }
    } catch (err) {
      setError('Error verifying CAPTCHA. Please try again.');
      console.error('Verification error:', err);
    } finally {
      setIsVerifying(false);
    }
  };

  const handleSubmit = async (e) => {
    e.preventDefault();
    setError('');

    if (!isVerified) {
      setError('Please complete the CAPTCHA verification first.');
      return;
    }

    setIsSubmitting(true);
    try {
      // Simulate API call
      await new Promise(resolve => setTimeout(resolve, 1500));
      alert('Form submitted successfully!');
      // Reset form
      setFormData({ name: '', email: '', subject: '', message: '' });
      setIsVerified(false);
    } catch (err) {
      setError('Error submitting form. Please try again.');
    } finally {
      setIsSubmitting(false);
    }
  };

  return (
    <div style={{ padding: '20px', maxWidth: '600px', margin: '0 auto' }}>
      <h1>Contact Form with ProCaptcha</h1>
      <form onSubmit={handleSubmit}>
        <div style={{ marginBottom: '16px' }}>
          <label style={{ display: 'block', marginBottom: '4px', fontWeight: '500' }}>
            Name *
          </label>
          <input
            type="text"
            name="name"
            value={formData.name}
            onChange={handleInputChange}
            required
            style={{
              width: '100%',
              padding: '8px',
              border: '1px solid #ddd',
              borderRadius: '4px',
              boxSizing: 'border-box'
            }}
          />
        </div>

        <div style={{ marginBottom: '16px' }}>
          <label style={{ display: 'block', marginBottom: '4px', fontWeight: '500' }}>
            Email *
          </label>
          <input
            type="email"
            name="email"
            value={formData.email}
            onChange={handleInputChange}
            required
            style={{
              width: '100%',
              padding: '8px',
              border: '1px solid #ddd',
              borderRadius: '4px',
              boxSizing: 'border-box'
            }}
          />
        </div>

        <div style={{ marginBottom: '16px' }}>
          <label style={{ display: 'block', marginBottom: '4px', fontWeight: '500' }}>
            Subject *
          </label>
          <input
            type="text"
            name="subject"
            value={formData.subject}
            onChange={handleInputChange}
            required
            style={{
              width: '100%',
              padding: '8px',
              border: '1px solid #ddd',
              borderRadius: '4px',
              boxSizing: 'border-box'
            }}
          />
        </div>

        <div style={{ marginBottom: '16px' }}>
          <label style={{ display: 'block', marginBottom: '4px', fontWeight: '500' }}>
            Message *
          </label>
          <textarea
            name="message"
            value={formData.message}
            onChange={handleInputChange}
            required
            rows={5}
            style={{
              width: '100%',
              padding: '8px',
              border: '1px solid #ddd',
              borderRadius: '4px',
              boxSizing: 'border-box',
              resize: 'vertical'
            }}
          />
        </div>

        <div style={{ marginBottom: '20px', padding: '15px', border: '1px solid #ddd', borderRadius: '4px', backgroundColor: '#f8f9fa' }}>
          <label style={{ display: 'block', marginBottom: '10px', fontWeight: '500' }}>
            CAPTCHA Verification *
          </label>
          {captcha && (
            <div style={{ marginBottom: '10px' }}>
              {captcha.render()}
            </div>
          )}
          <button
            type="button"
            onClick={handleVerify}
            disabled={isVerifying || isVerified}
            style={{
              padding: '8px 16px',
              backgroundColor: (isVerifying || isVerified) ? '#6c757d' : '#28a745',
              color: 'white',
              border: 'none',
              borderRadius: '4px',
              cursor: (isVerifying || isVerified) ? 'not-allowed' : 'pointer'
            }}
          >
            {isVerifying ? 'Verifying...' : isVerified ? '✓ Verified' : 'Verify CAPTCHA'}
          </button>
        </div>

        {error && (
          <div style={{
            padding: '10px',
            backgroundColor: '#f8d7da',
            color: '#721c24',
            borderRadius: '4px',
            marginBottom: '16px'
          }}>
            {error}
          </div>
        )}

        <button
          type="submit"
          disabled={!isVerified || isSubmitting}
          style={{
            padding: '10px 20px',
            backgroundColor: (!isVerified || isSubmitting) ? '#6c757d' : '#007bff',
            color: 'white',
            border: 'none',
            borderRadius: '4px',
            cursor: (!isVerified || isSubmitting) ? 'not-allowed' : 'pointer',
            width: '100%',
            fontSize: '16px'
          }}
        >
          {isSubmitting ? 'Submitting...' : 'Submit Form'}
        </button>
      </form>
    </div>
  );
}

export default ContactFormWithProCaptcha;

Update your App.jsx:

// src/App.jsx
import React from 'react';
import ContactFormWithProCaptcha from './ContactFormWithProCaptcha';
import './App.css';

function App() {
  return (
    <div className="App">
      <ContactFormWithProCaptcha />
    </div>
  );
}

export default App;

This example demonstrates:

Contact form with ProCaptcha protection
Form validation
CAPTCHA verification
Error handling
User feedback
Privacy-preserving bot protection

Common Issues / Troubleshooting

Provider not configured: Make sure you've wrapped your app with ProsopoProvider and provided the required configuration (dappName, networkId).
Hook not working: Ensure you're using useProsopo hook inside a component that's wrapped by ProsopoProvider. The hook must be used within the provider context.
Verification failing: Check that the CAPTCHA challenge is completed correctly. The verification process is async, so handle it with proper error handling.
Network configuration: Ensure the networkId in the provider config matches your environment. Use 'development' for local development.
Captcha not rendering: Make sure captcha is available from the hook before calling captcha.render(). Check that the provider is properly initialized.
State management: Track verification state in your component. The verify() function returns a promise that resolves to a boolean indicating verification success.

Next Steps

Now that you have an understanding of ProCaptcha:

Learn about advanced CAPTCHA configurations
Explore network-specific settings
Implement CAPTCHA in different form types
Add CAPTCHA to authentication flows
Learn about privacy-preserving features
Check the official repository: https://github.com/prosopo/captcha
Look for part 57 of this series for more advanced topics

Summary

You've successfully integrated ProCaptcha into your React application and created CAPTCHA protection for forms. ProCaptcha provides a privacy-preserving, decentralized solution for bot protection with flexible configuration options.

SEO Keywords

procaptcha
React ProCaptcha
procaptcha tutorial
React privacy CAPTCHA
procaptcha installation
React Prosopo CAPTCHA
procaptcha example
React decentralized CAPTCHA
procaptcha setup
React bot protection
procaptcha customization
React CAPTCHA library
procaptcha verification
React privacy-preserving
procaptcha getting started

Getting Started with React Simple Captcha: Building CAPTCHA Protection

Joseph Nelson — Mon, 19 Jan 2026 17:12:15 +0000

React Simple Captcha is a lightweight library for creating simple CAPTCHA (Completely Automated Public Turing test to tell Computers and Humans Apart) components in React applications. It provides an easy way to add basic bot protection to forms and user interactions. This guide walks through setting up and creating CAPTCHA protection using React Simple Captcha with React, from installation to a working implementation. This is part 55 of a series on using React Simple Captcha with React.

Prerequisites

Before you begin, make sure you have:

Node.js version 14.0 or higher installed
npm, yarn, or pnpm package manager
A React project (version 16.8 or higher) or create-react-app setup
Basic knowledge of React components and forms
Familiarity with JavaScript/TypeScript

Installation

Install React Simple Captcha using your preferred package manager:

npm install react-simple-captcha

Or with yarn:

yarn add react-simple-captcha

Or with pnpm:

pnpm add react-simple-captcha

After installation, your package.json should include:

{
  "dependencies": {
    "react-simple-captcha": "^1.0.0",
    "react": "^18.0.0",
    "react-dom": "^18.0.0"
  }
}

Project Setup

React Simple Captcha requires minimal setup. Import the component and you're ready to use it.

First Example / Basic Usage

Let's create a simple CAPTCHA form. Create a new file src/CaptchaExample.jsx:

// src/CaptchaExample.jsx
import React, { useState } from 'react';
import { loadCaptchaEnginge, LoadCanvasTemplate, validateCaptcha } from 'react-simple-captcha';

function CaptchaExample() {
  const [captchaValue, setCaptchaValue] = useState('');
  const [isValid, setIsValid] = useState(null);

  React.useEffect(() => {
    loadCaptchaEnginge(6); // Load CAPTCHA with 6 characters
  }, []);

  const handleSubmit = (e) => {
    e.preventDefault();
    const valid = validateCaptcha(captchaValue);
    setIsValid(valid);
    if (valid) {
      alert('CAPTCHA validated successfully!');
    } else {
      alert('Invalid CAPTCHA. Please try again.');
      loadCaptchaEnginge(6); // Reload CAPTCHA
      setCaptchaValue('');
    }
  };

  return (
    <div style={{ padding: '20px', maxWidth: '400px', margin: '0 auto' }}>
      <h2>CAPTCHA Example</h2>
      <form onSubmit={handleSubmit}>
        <div style={{ marginBottom: '20px' }}>
          <LoadCanvasTemplate />
        </div>
        <div style={{ marginBottom: '20px' }}>
          <label style={{ display: 'block', marginBottom: '5px' }}>
            Enter CAPTCHA:
          </label>
          <input
            type="text"
            value={captchaValue}
            onChange={(e) => setCaptchaValue(e.target.value)}
            style={{
              width: '100%',
              padding: '8px',
              border: '1px solid #ddd',
              borderRadius: '4px',
              boxSizing: 'border-box'
            }}
            placeholder="Enter the text above"
          />
        </div>
        <button
          type="submit"
          style={{
            padding: '10px 20px',
            backgroundColor: '#007bff',
            color: 'white',
            border: 'none',
            borderRadius: '4px',
            cursor: 'pointer',
            width: '100%'
          }}
        >
          Submit
        </button>
        {isValid === false && (
          <p style={{ color: 'red', marginTop: '10px' }}>
            Invalid CAPTCHA. Please try again.
          </p>
        )}
      </form>
    </div>
  );
}

export default CaptchaExample;

Update your App.jsx:

// src/App.jsx
import React from 'react';
import CaptchaExample from './CaptchaExample';
import './App.css';

function App() {
  return (
    <div className="App">
      <CaptchaExample />
    </div>
  );
}

export default App;

This creates a basic CAPTCHA form that validates user input against the displayed CAPTCHA.

Understanding the Basics

React Simple Captcha provides several key functions:

loadCaptchaEnginge: Initializes the CAPTCHA engine with a specified number of characters
LoadCanvasTemplate: Renders the CAPTCHA image
validateCaptcha: Validates the user's input against the CAPTCHA
Simple API: Easy to use with minimal configuration
Customizable: Can adjust character count and styling

Key concepts:

CAPTCHA Generation: The library generates random text-based CAPTCHAs
Validation: User input is compared against the generated CAPTCHA
Reload: CAPTCHA can be reloaded if validation fails
Canvas Rendering: CAPTCHA is rendered on a canvas element
Form Integration: Works seamlessly with React forms

Here's an example with a reload button and custom styling:

// src/AdvancedCaptchaExample.jsx
import React, { useState } from 'react';
import { loadCaptchaEnginge, LoadCanvasTemplate, validateCaptcha } from 'react-simple-captcha';

function AdvancedCaptchaExample() {
  const [captchaValue, setCaptchaValue] = useState('');
  const [isValid, setIsValid] = useState(null);
  const [charCount, setCharCount] = useState(6);

  React.useEffect(() => {
    loadCaptchaEnginge(charCount);
  }, [charCount]);

  const handleReload = () => {
    loadCaptchaEnginge(charCount);
    setCaptchaValue('');
    setIsValid(null);
  };

  const handleSubmit = (e) => {
    e.preventDefault();
    const valid = validateCaptcha(captchaValue);
    setIsValid(valid);
    if (valid) {
      alert('CAPTCHA validated successfully!');
    } else {
      handleReload();
    }
  };

  return (
    <div style={{ padding: '20px', maxWidth: '400px', margin: '0 auto' }}>
      <h2>Advanced CAPTCHA Example</h2>
      <form onSubmit={handleSubmit}>
        <div style={{ marginBottom: '20px' }}>
          <label style={{ display: 'block', marginBottom: '5px' }}>
            Character Count:
          </label>
          <input
            type="number"
            min="4"
            max="8"
            value={charCount}
            onChange={(e) => setCharCount(Number(e.target.value))}
            style={{
              padding: '5px',
              border: '1px solid #ddd',
              borderRadius: '4px',
              width: '100px'
            }}
          />
        </div>
        <div style={{ marginBottom: '20px', border: '1px solid #ddd', padding: '15px', borderRadius: '4px' }}>
          <LoadCanvasTemplate />
          <button
            type="button"
            onClick={handleReload}
            style={{
              marginTop: '10px',
              padding: '5px 10px',
              backgroundColor: '#6c757d',
              color: 'white',
              border: 'none',
              borderRadius: '4px',
              cursor: 'pointer',
              fontSize: '12px'
            }}
          >
            Reload CAPTCHA
          </button>
        </div>
        <div style={{ marginBottom: '20px' }}>
          <label style={{ display: 'block', marginBottom: '5px' }}>
            Enter CAPTCHA:
          </label>
          <input
            type="text"
            value={captchaValue}
            onChange={(e) => setCaptchaValue(e.target.value)}
            style={{
              width: '100%',
              padding: '8px',
              border: isValid === false ? '2px solid red' : '1px solid #ddd',
              borderRadius: '4px',
              boxSizing: 'border-box'
            }}
            placeholder="Enter the text above"
          />
        </div>
        <button
          type="submit"
          style={{
            padding: '10px 20px',
            backgroundColor: '#007bff',
            color: 'white',
            border: 'none',
            borderRadius: '4px',
            cursor: 'pointer',
            width: '100%'
          }}
        >
          Validate CAPTCHA
        </button>
        {isValid === true && (
          <p style={{ color: 'green', marginTop: '10px' }}>
            CAPTCHA validated successfully!
          </p>
        )}
        {isValid === false && (
          <p style={{ color: 'red', marginTop: '10px' }}>
            Invalid CAPTCHA. Please try again.
          </p>
        )}
      </form>
    </div>
  );
}

export default AdvancedCaptchaExample;

Practical Example / Building Something Real

Let's build a complete contact form with CAPTCHA protection:

// src/ContactFormWithCaptcha.jsx
import React, { useState } from 'react';
import { loadCaptchaEnginge, LoadCanvasTemplate, validateCaptcha } from 'react-simple-captcha';

function ContactFormWithCaptcha() {
  const [formData, setFormData] = useState({
    name: '',
    email: '',
    message: ''
  });
  const [captchaValue, setCaptchaValue] = useState('');
  const [isValid, setIsValid] = useState(null);
  const [isSubmitting, setIsSubmitting] = useState(false);

  React.useEffect(() => {
    loadCaptchaEnginge(6);
  }, []);

  const handleInputChange = (e) => {
    const { name, value } = e.target;
    setFormData(prev => ({ ...prev, [name]: value }));
  };

  const handleReloadCaptcha = () => {
    loadCaptchaEnginge(6);
    setCaptchaValue('');
    setIsValid(null);
  };

  const handleSubmit = async (e) => {
    e.preventDefault();
    setIsSubmitting(true);

    // Validate CAPTCHA first
    const captchaValid = validateCaptcha(captchaValue);
    setIsValid(captchaValid);

    if (!captchaValid) {
      setIsSubmitting(false);
      handleReloadCaptcha();
      return;
    }

    // Simulate form submission
    try {
      await new Promise(resolve => setTimeout(resolve, 1000));
      alert('Form submitted successfully!');
      // Reset form
      setFormData({ name: '', email: '', message: '' });
      setCaptchaValue('');
      handleReloadCaptcha();
    } catch (error) {
      alert('Error submitting form. Please try again.');
    } finally {
      setIsSubmitting(false);
    }
  };

  return (
    <div style={{ padding: '20px', maxWidth: '600px', margin: '0 auto' }}>
      <h1>Contact Form with CAPTCHA</h1>
      <form onSubmit={handleSubmit}>
        <div style={{ marginBottom: '16px' }}>
          <label style={{ display: 'block', marginBottom: '4px', fontWeight: '500' }}>
            Name *
          </label>
          <input
            type="text"
            name="name"
            value={formData.name}
            onChange={handleInputChange}
            required
            style={{
              width: '100%',
              padding: '8px',
              border: '1px solid #ddd',
              borderRadius: '4px',
              boxSizing: 'border-box'
            }}
          />
        </div>

        <div style={{ marginBottom: '16px' }}>
          <label style={{ display: 'block', marginBottom: '4px', fontWeight: '500' }}>
            Email *
          </label>
          <input
            type="email"
            name="email"
            value={formData.email}
            onChange={handleInputChange}
            required
            style={{
              width: '100%',
              padding: '8px',
              border: '1px solid #ddd',
              borderRadius: '4px',
              boxSizing: 'border-box'
            }}
          />
        </div>

        <div style={{ marginBottom: '16px' }}>
          <label style={{ display: 'block', marginBottom: '4px', fontWeight: '500' }}>
            Message *
          </label>
          <textarea
            name="message"
            value={formData.message}
            onChange={handleInputChange}
            required
            rows={4}
            style={{
              width: '100%',
              padding: '8px',
              border: '1px solid #ddd',
              borderRadius: '4px',
              boxSizing: 'border-box',
              resize: 'vertical'
            }}
          />
        </div>

        <div style={{ marginBottom: '20px', padding: '15px', border: '1px solid #ddd', borderRadius: '4px', backgroundColor: '#f8f9fa' }}>
          <label style={{ display: 'block', marginBottom: '10px', fontWeight: '500' }}>
            CAPTCHA Verification *
          </label>
          <div style={{ marginBottom: '10px' }}>
            <LoadCanvasTemplate />
          </div>
          <button
            type="button"
            onClick={handleReloadCaptcha}
            style={{
              padding: '5px 10px',
              backgroundColor: '#6c757d',
              color: 'white',
              border: 'none',
              borderRadius: '4px',
              cursor: 'pointer',
              fontSize: '12px',
              marginBottom: '10px'
            }}
          >
            Reload CAPTCHA
          </button>
          <input
            type="text"
            value={captchaValue}
            onChange={(e) => setCaptchaValue(e.target.value)}
            style={{
              width: '100%',
              padding: '8px',
              border: isValid === false ? '2px solid red' : '1px solid #ddd',
              borderRadius: '4px',
              boxSizing: 'border-box'
            }}
            placeholder="Enter CAPTCHA text"
            required
          />
          {isValid === false && (
            <p style={{ color: 'red', marginTop: '5px', fontSize: '14px' }}>
              Invalid CAPTCHA. Please try again.
            </p>
          )}
        </div>

        <button
          type="submit"
          disabled={isSubmitting}
          style={{
            padding: '10px 20px',
            backgroundColor: isSubmitting ? '#6c757d' : '#007bff',
            color: 'white',
            border: 'none',
            borderRadius: '4px',
            cursor: isSubmitting ? 'not-allowed' : 'pointer',
            width: '100%',
            fontSize: '16px'
          }}
        >
          {isSubmitting ? 'Submitting...' : 'Submit Form'}
        </button>
      </form>
    </div>
  );
}

export default ContactFormWithCaptcha;

Update your App.jsx:

// src/App.jsx
import React from 'react';
import ContactFormWithCaptcha from './ContactFormWithCaptcha';
import './App.css';

function App() {
  return (
    <div className="App">
      <ContactFormWithCaptcha />
    </div>
  );
}

export default App;

This example demonstrates:

Contact form with CAPTCHA protection
Form validation
CAPTCHA validation
Reload functionality
Error handling
User feedback

Common Issues / Troubleshooting

CAPTCHA not displaying: Make sure you've called loadCaptchaEnginge() before rendering LoadCanvasTemplate. This should be done in a useEffect hook.
Validation not working: Ensure you're calling validateCaptcha() with the user's input value. The validation is case-sensitive by default.
CAPTCHA not reloading: Call loadCaptchaEnginge() again to reload the CAPTCHA. Make sure to clear the input value when reloading.
Canvas not rendering: Check that the canvas element has proper dimensions. The library handles this automatically, but ensure there are no CSS conflicts.
Character count: Adjust the number passed to loadCaptchaEnginge() to change the number of characters. Common values are 4-8 characters.
Styling issues: The CAPTCHA is rendered on a canvas, so you can style the container but not the canvas content directly. Use CSS to style the container div.

Next Steps

Now that you have a basic understanding of React Simple Captcha:

Learn about advanced CAPTCHA configurations
Explore custom styling options
Implement CAPTCHA in different form types
Add CAPTCHA to login and registration forms
Learn about other CAPTCHA libraries (react-google-recaptcha)
Check the official repository: https://github.com/masroorejaz/react-simple-captcha
Look for part 56 of this series for more advanced topics

Summary

You've successfully set up React Simple Captcha in your React application and created CAPTCHA protection for forms. React Simple Captcha provides a simple solution for adding basic bot protection to your applications with minimal configuration.

SEO Keywords

react-simple-captcha
React CAPTCHA component
react-simple-captcha tutorial
React bot protection
react-simple-captcha installation
React form CAPTCHA
react-simple-captcha example
React captcha validation
react-simple-captcha setup
React security CAPTCHA
react-simple-captcha customization
React captcha library
react-simple-captcha forms
React captcha protection
react-simple-captcha getting started

Advanced Skeleton Loaders with react-content-loader in React

Joseph Nelson — Mon, 19 Jan 2026 17:11:01 +0000

react-content-loader is a SVG-powered library for creating placeholder loading animations (skeleton loaders) in React applications. It provides a flexible way to create Facebook-style loading placeholders that match your content structure, improving perceived performance and user experience. This guide walks through advanced usage of react-content-loader with React, including custom loaders, pre-defined patterns, and complex skeleton structures. This is part 54 of a series on using react-content-loader with React.

Prerequisites

Before you begin, make sure you have:

Node.js version 14.0 or higher installed
npm, yarn, or pnpm package manager
A React project (version 16.8 or higher) or create-react-app setup
Basic knowledge of React hooks (useState, useEffect)
Familiarity with SVG and CSS
Understanding of async operations and loading states

Installation

Install react-content-loader using your preferred package manager:

npm install react-content-loader

Or with yarn:

yarn add react-content-loader

Or with pnpm:

pnpm add react-content-loader

After installation, your package.json should include:

{
  "dependencies": {
    "react-content-loader": "^7.0.0",
    "react": "^18.0.0",
    "react-dom": "^18.0.0"
  }
}

Project Setup

react-content-loader requires no additional setup. Import the components and you're ready to use them.

First Example / Basic Usage

Let's create a simple skeleton loader. Create a new file src/ContentLoaderExample.jsx:

// src/ContentLoaderExample.jsx
import React, { useState, useEffect } from 'react';
import ContentLoader from 'react-content-loader';

function ContentLoaderExample() {
  const [isLoading, setIsLoading] = useState(true);
  const [data, setData] = useState(null);

  useEffect(() => {
    // Simulate API call
    setTimeout(() => {
      setData({ title: 'Loaded Content', description: 'This content was loaded successfully!' });
      setIsLoading(false);
    }, 2000);
  }, []);

  if (isLoading) {
    return (
      <div style={{ padding: '20px' }}>
        <ContentLoader
          viewBox="0 0 400 160"
          height={160}
          width={400}
          backgroundColor="#f3f3f3"
          foregroundColor="#ecebeb"
        >
          <rect x="0" y="0" rx="5" ry="5" width="400" height="160" />
        </ContentLoader>
      </div>
    );
  }

  return (
    <div style={{ padding: '20px' }}>
      <h2>{data.title}</h2>
      <p>{data.description}</p>
    </div>
  );
}

export default ContentLoaderExample;

Update your App.jsx:

// src/App.jsx
import React from 'react';
import ContentLoaderExample from './ContentLoaderExample';
import './App.css';

function App() {
  return (
    <div className="App">
      <ContentLoaderExample />
    </div>
  );
}

export default App;

This creates a basic skeleton loader that displays while content is loading.

Understanding the Basics

react-content-loader provides several key features:

ContentLoader component: Main component for creating custom loaders
Pre-defined loaders: Facebook, Instagram, Code, List, BulletList patterns
SVG-based: Uses SVG for smooth animations
Customizable: Colors, speed, size, and shapes
Responsive: Works with different screen sizes

Key concepts for advanced usage:

SVG Shapes: Use <rect>, <circle>, and other SVG elements to create loaders
viewBox: Defines the coordinate system and aspect ratio
Animation: Automatic shimmer animation effect
Customization: Control colors, speed, and animation behavior
Pre-defined Patterns: Use ready-made loaders for common layouts

Here's an example with pre-defined loaders:

// src/PredefinedLoadersExample.jsx
import React, { useState } from 'react';
import { Facebook, Instagram, Code, List, BulletList } from 'react-content-loader';

function PredefinedLoadersExample() {
  const [selectedLoader, setSelectedLoader] = useState('Facebook');

  const loaders = {
    Facebook: <Facebook />,
    Instagram: <Instagram />,
    Code: <Code />,
    List: <List />,
    BulletList: <BulletList />
  };

  return (
    <div style={{ padding: '20px' }}>
      <h2>Pre-defined Loaders</h2>
      <div style={{ marginBottom: '20px' }}>
        <label>Select Loader: </label>
        <select
          value={selectedLoader}
          onChange={(e) => setSelectedLoader(e.target.value)}
          style={{ padding: '5px', marginLeft: '10px' }}
        >
          {Object.keys(loaders).map(type => (
            <option key={type} value={type}>{type}</option>
          ))}
        </select>
      </div>
      <div style={{ border: '1px solid #ddd', padding: '20px', borderRadius: '8px' }}>
        {loaders[selectedLoader]}
      </div>
    </div>
  );
}

export default PredefinedLoadersExample;

Practical Example / Building Something Real

Let's build a comprehensive skeleton loader system with custom patterns:

// src/CardSkeletonLoader.jsx
import React from 'react';
import ContentLoader from 'react-content-loader';

function CardSkeletonLoader() {
  return (
    <ContentLoader
      viewBox="0 0 400 200"
      height={200}
      width={400}
      backgroundColor="#f3f3f3"
      foregroundColor="#ecebeb"
    >
      {/* Avatar */}
      <circle cx="50" cy="50" r="30" />
      {/* Title */}
      <rect x="100" y="20" rx="4" ry="4" width="200" height="20" />
      {/* Subtitle */}
      <rect x="100" y="50" rx="3" ry="3" width="150" height="15" />
      {/* Content lines */}
      <rect x="20" y="100" rx="3" ry="3" width="360" height="10" />
      <rect x="20" y="120" rx="3" ry="3" width="320" height="10" />
      <rect x="20" y="140" rx="3" ry="3" width="280" height="10" />
      {/* Button */}
      <rect x="20" y="170" rx="5" ry="5" width="100" height="25" />
    </ContentLoader>
  );
}

export default CardSkeletonLoader;

Create a list skeleton loader:

// src/ListSkeletonLoader.jsx
import React from 'react';
import ContentLoader from 'react-content-loader';

function ListSkeletonLoader({ items = 3 }) {
  return (
    <div>
      {Array.from({ length: items }).map((_, index) => (
        <ContentLoader
          key={index}
          viewBox="0 0 400 80"
          height={80}
          width={400}
          backgroundColor="#f3f3f3"
          foregroundColor="#ecebeb"
          style={{ marginBottom: '10px' }}
        >
          {/* Icon */}
          <rect x="10" y="10" rx="5" ry="5" width="60" height="60" />
          {/* Title */}
          <rect x="80" y="20" rx="4" ry="4" width="200" height="15" />
          {/* Description */}
          <rect x="80" y="45" rx="3" ry="3" width="300" height="10" />
        </ContentLoader>
      ))}
    </div>
  );
}

export default ListSkeletonLoader;

Create a table skeleton loader:

// src/TableSkeletonLoader.jsx
import React from 'react';
import ContentLoader from 'react-content-loader';

function TableSkeletonLoader({ rows = 5, columns = 4 }) {
  const cellWidth = 380 / columns;
  const cellHeight = 30;
  const rowHeight = 50;

  return (
    <ContentLoader
      viewBox={`0 0 400 ${rows * rowHeight + 40}`}
      height={rows * rowHeight + 40}
      width={400}
      backgroundColor="#f3f3f3"
      foregroundColor="#ecebeb"
    >
      {/* Header row */}
      {Array.from({ length: columns }).map((_, colIndex) => (
        <rect
          key={`header-${colIndex}`}
          x={10 + colIndex * cellWidth}
          y={10}
          rx="3"
          ry="3"
          width={cellWidth - 20}
          height={cellHeight}
        />
      ))}
      {/* Data rows */}
      {Array.from({ length: rows }).map((_, rowIndex) =>
        Array.from({ length: columns }).map((_, colIndex) => (
          <rect
            key={`row-${rowIndex}-col-${colIndex}`}
            x={10 + colIndex * cellWidth}
            y={50 + rowIndex * rowHeight}
            rx="3"
            ry="3"
            width={cellWidth - 20}
            height={cellHeight}
          />
        ))
      )}
    </ContentLoader>
  );
}

export default TableSkeletonLoader;

Now create a complete loading system:

// src/AdvancedLoadingSystem.jsx
import React, { useState, useEffect } from 'react';
import CardSkeletonLoader from './CardSkeletonLoader';
import ListSkeletonLoader from './ListSkeletonLoader';
import TableSkeletonLoader from './TableSkeletonLoader';

function AdvancedLoadingSystem() {
  const [loadingStates, setLoadingStates] = useState({
    card: true,
    list: true,
    table: true
  });

  const [data, setData] = useState({
    card: null,
    list: null,
    table: null
  });

  useEffect(() => {
    // Simulate loading card data
    setTimeout(() => {
      setData(prev => ({
        ...prev,
        card: { title: 'Card Title', description: 'Card description' }
      }));
      setLoadingStates(prev => ({ ...prev, card: false }));
    }, 2000);

    // Simulate loading list data
    setTimeout(() => {
      setData(prev => ({
        ...prev,
        list: [
          { id: 1, title: 'Item 1', description: 'Description 1' },
          { id: 2, title: 'Item 2', description: 'Description 2' },
          { id: 3, title: 'Item 3', description: 'Description 3' }
        ]
      }));
      setLoadingStates(prev => ({ ...prev, list: false }));
    }, 2500);

    // Simulate loading table data
    setTimeout(() => {
      setData(prev => ({
        ...prev,
        table: [
          { id: 1, name: 'John', email: 'john@example.com' },
          { id: 2, name: 'Jane', email: 'jane@example.com' },
          { id: 3, name: 'Bob', email: 'bob@example.com' }
        ]
      }));
      setLoadingStates(prev => ({ ...prev, table: false }));
    }, 3000);
  }, []);

  return (
    <div style={{ padding: '20px' }}>
      <h1>Advanced Loading System</h1>

      {/* Card Section */}
      <section style={{ marginBottom: '40px', padding: '20px', border: '1px solid #ddd', borderRadius: '8px' }}>
        <h2>Card Loading</h2>
        {loadingStates.card ? (
          <CardSkeletonLoader />
        ) : (
          <div style={{ padding: '20px', backgroundColor: '#f8f9fa', borderRadius: '8px' }}>
            <h3>{data.card?.title}</h3>
            <p>{data.card?.description}</p>
          </div>
        )}
      </section>

      {/* List Section */}
      <section style={{ marginBottom: '40px', padding: '20px', border: '1px solid #ddd', borderRadius: '8px' }}>
        <h2>List Loading</h2>
        {loadingStates.list ? (
          <ListSkeletonLoader items={3} />
        ) : (
          <div>
            {data.list?.map(item => (
              <div key={item.id} style={{ padding: '15px', marginBottom: '10px', backgroundColor: '#f8f9fa', borderRadius: '4px' }}>
                <h4>{item.title}</h4>
                <p>{item.description}</p>
              </div>
            ))}
          </div>
        )}
      </section>

      {/* Table Section */}
      <section style={{ marginBottom: '40px', padding: '20px', border: '1px solid #ddd', borderRadius: '8px' }}>
        <h2>Table Loading</h2>
        {loadingStates.table ? (
          <TableSkeletonLoader rows={3} columns={3} />
        ) : (
          <table style={{ width: '100%', borderCollapse: 'collapse' }}>
            <thead>
              <tr style={{ backgroundColor: '#007bff', color: 'white' }}>
                <th style={{ padding: '10px', textAlign: 'left' }}>ID</th>
                <th style={{ padding: '10px', textAlign: 'left' }}>Name</th>
                <th style={{ padding: '10px', textAlign: 'left' }}>Email</th>
              </tr>
            </thead>
            <tbody>
              {data.table?.map(row => (
                <tr key={row.id} style={{ borderBottom: '1px solid #ddd' }}>
                  <td style={{ padding: '10px' }}>{row.id}</td>
                  <td style={{ padding: '10px' }}>{row.name}</td>
                  <td style={{ padding: '10px' }}>{row.email}</td>
                </tr>
              ))}
            </tbody>
          </table>
        )}
      </section>
    </div>
  );
}

export default AdvancedLoadingSystem;

Update your App.jsx:

// src/App.jsx
import React from 'react';
import AdvancedLoadingSystem from './AdvancedLoadingSystem';
import PredefinedLoadersExample from './PredefinedLoadersExample';
import './App.css';

function App() {
  return (
    <div className="App">
      <AdvancedLoadingSystem />
      <PredefinedLoadersExample />
    </div>
  );
}

export default App;

This example demonstrates:

Custom skeleton loaders for cards, lists, and tables
Pre-defined loader patterns
Multiple loading states
Responsive skeleton structures
Matching content layout

Common Issues / Troubleshooting

Loader not displaying: Make sure you're using SVG elements (<rect>, <circle>) inside ContentLoader. Regular HTML elements won't work.
Sizing issues: Use the viewBox prop to define the coordinate system. The width and height props control the rendered size.
Animation not working: Check that animate prop is true (default). Also ensure you're using valid SVG shapes.
Colors not applying: Use backgroundColor and foregroundColor props to customize colors. These control the shimmer animation colors.
Layout mismatch: Design your skeleton loader to match your actual content layout. Use the same spacing and dimensions for best results.
Performance: react-content-loader uses SVG which is performant, but if you have many loaders, consider using conditional rendering to only show them when needed.

Next Steps

Now that you have an advanced understanding of react-content-loader:

Explore all pre-defined loader patterns
Learn about advanced SVG customization
Create loaders that match your exact content structure
Implement responsive skeleton loaders
Add skeleton loaders to data fetching hooks
Learn about other skeleton loader libraries
Check the official repository: https://github.com/danilowoz/react-content-loader
Look for part 55 of this series for more advanced topics

Summary

You've successfully integrated react-content-loader into your React application with advanced features including custom skeleton loaders for cards, lists, and tables, pre-defined patterns, and comprehensive loading states. react-content-loader provides a flexible, SVG-based solution for creating professional skeleton loaders that improve perceived performance.

SEO Keywords

react-content-loader
React skeleton loader
react-content-loader tutorial
React placeholder loading
react-content-loader installation
React SVG skeleton
react-content-loader example
React loading placeholder
react-content-loader setup
React Facebook loader
react-content-loader customization
React skeleton pattern
react-content-loader SVG
React loading library
react-content-loader getting started

Building Loading Spinners with react-spinners in React

Joseph Nelson — Mon, 19 Jan 2026 17:09:55 +0000

react-spinners is a collection of animated loading spinner components for React applications. It provides a variety of spinner styles with customizable colors, sizes, and speeds, making it easy to add professional loading indicators to your app. This guide walks through setting up and creating loading spinners using react-spinners with React, from installation to a working implementation. This is part 53 of a series on using react-spinners with React.

Prerequisites

Before you begin, make sure you have:

Node.js version 14.0 or higher installed
npm, yarn, or pnpm package manager
A React project (version 16.8 or higher) or create-react-app setup
Basic knowledge of React hooks (useState, useEffect)
Familiarity with JavaScript/TypeScript
Understanding of async operations

Installation

Install react-spinners using your preferred package manager:

npm install react-spinners

Or with yarn:

yarn add react-spinners

Or with pnpm:

pnpm add react-spinners

After installation, your package.json should include:

{
  "dependencies": {
    "react-spinners": "^0.13.0",
    "react": "^18.0.0",
    "react-dom": "^18.0.0"
  }
}

Project Setup

react-spinners requires no additional setup. Import the spinner components and you're ready to use them.

First Example / Basic Usage

Let's create a simple loading spinner. Create a new file src/SpinnerExample.jsx:

// src/SpinnerExample.jsx
import React, { useState } from 'react';
import { ClipLoader } from 'react-spinners';

function SpinnerExample() {
  const [isLoading, setIsLoading] = useState(false);

  const handleLoad = async () => {
    setIsLoading(true);
    // Simulate API call
    await new Promise(resolve => setTimeout(resolve, 2000));
    setIsLoading(false);
  };

  return (
    <div style={{ padding: '20px', textAlign: 'center' }}>
      <h2>Loading Spinner Example</h2>
      <button
        onClick={handleLoad}
        disabled={isLoading}
        style={{
          padding: '10px 20px',
          backgroundColor: '#007bff',
          color: 'white',
          border: 'none',
          borderRadius: '4px',
          cursor: isLoading ? 'not-allowed' : 'pointer',
          marginBottom: '20px'
        }}
      >
        {isLoading ? 'Loading...' : 'Start Loading'}
      </button>
      {isLoading && (
        <div style={{ display: 'flex', justifyContent: 'center', alignItems: 'center' }}>
          <ClipLoader color="#007bff" size={50} />
        </div>
      )}
    </div>
  );
}

export default SpinnerExample;

Update your App.jsx:

// src/App.jsx
import React from 'react';
import SpinnerExample from './SpinnerExample';
import './App.css';

function App() {
  return (
    <div className="App">
      <SpinnerExample />
    </div>
  );
}

export default App;

This creates a loading spinner that appears when the button is clicked and disappears after the async operation completes.

Understanding the Basics

react-spinners provides many spinner types:

ClipLoader: Clip animation
BeatLoader: Beat animation
BounceLoader: Bounce animation
CircleLoader: Circle animation
ClimbingBoxLoader: Climbing box animation
DotLoader: Dot animation
FadeLoader: Fade animation
GridLoader: Grid animation
HashLoader: Hash animation
MoonLoader: Moon animation
PacmanLoader: Pacman animation
PropagateLoader: Propagate animation
PuffLoader: Puff animation
PulseLoader: Pulse animation
RingLoader: Ring animation
RiseLoader: Rise animation
RotateLoader: Rotate animation
ScaleLoader: Scale animation
SyncLoader: Sync animation
And many more...

Key concepts:

Spinner Components: Each spinner type is a separate component
Color Prop: Customize spinner color
Size Prop: Control spinner size
Loading Prop: Control visibility with loading prop
SpeedMultiplier: Adjust animation speed
CSS Override: Customize with cssOverride prop

Here's an example with different spinner types and customization:

// src/MultipleSpinnersExample.jsx
import React, { useState } from 'react';
import { ClipLoader, BeatLoader, BounceLoader, CircleLoader, HashLoader } from 'react-spinners';

function MultipleSpinnersExample() {
  const [selectedSpinner, setSelectedSpinner] = useState('ClipLoader');
  const [color, setColor] = useState('#007bff');
  const [size, setSize] = useState(50);
  const [speed, setSpeed] = useState(1);

  const spinners = {
    ClipLoader: <ClipLoader color={color} size={size} speedMultiplier={speed} />,
    BeatLoader: <BeatLoader color={color} size={size} speedMultiplier={speed} />,
    BounceLoader: <BounceLoader color={color} size={size} speedMultiplier={speed} />,
    CircleLoader: <CircleLoader color={color} size={size} speedMultiplier={speed} />,
    HashLoader: <HashLoader color={color} size={size} speedMultiplier={speed} />
  };

  return (
    <div style={{ padding: '20px', textAlign: 'center' }}>
      <h2>Multiple Spinner Types</h2>
      <div style={{ marginBottom: '20px', display: 'flex', flexDirection: 'column', gap: '10px', maxWidth: '300px', margin: '0 auto 20px' }}>
        <div>
          <label>Select Spinner: </label>
          <select
            value={selectedSpinner}
            onChange={(e) => setSelectedSpinner(e.target.value)}
            style={{ padding: '5px', marginLeft: '10px' }}
          >
            {Object.keys(spinners).map(type => (
              <option key={type} value={type}>{type}</option>
            ))}
          </select>
        </div>
        <div>
          <label>Color: </label>
          <input
            type="color"
            value={color}
            onChange={(e) => setColor(e.target.value)}
            style={{ marginLeft: '10px' }}
          />
        </div>
        <div>
          <label>Size: </label>
          <input
            type="range"
            min="20"
            max="100"
            value={size}
            onChange={(e) => setSize(Number(e.target.value))}
            style={{ marginLeft: '10px' }}
          />
          <span style={{ marginLeft: '10px' }}>{size}px</span>
        </div>
        <div>
          <label>Speed: </label>
          <input
            type="range"
            min="0.5"
            max="2"
            step="0.1"
            value={speed}
            onChange={(e) => setSpeed(Number(e.target.value))}
            style={{ marginLeft: '10px' }}
          />
          <span style={{ marginLeft: '10px' }}>{speed}x</span>
        </div>
      </div>
      <div style={{ display: 'flex', justifyContent: 'center', alignItems: 'center', minHeight: '200px' }}>
        {spinners[selectedSpinner]}
      </div>
    </div>
  );
}

export default MultipleSpinnersExample;

Practical Example / Building Something Real

Let's build a comprehensive loading system with different spinner types and use cases:

// src/LoadingSystem.jsx
import React, { useState } from 'react';
import { ClipLoader, BeatLoader, HashLoader, PulseLoader, ScaleLoader } from 'react-spinners';

function LoadingSystem() {
  const [loadingStates, setLoadingStates] = useState({
    button: false,
    inline: false,
    page: false,
    overlay: false
  });

  const simulateApiCall = async (type) => {
    setLoadingStates(prev => ({ ...prev, [type]: true }));
    await new Promise(resolve => setTimeout(resolve, 2000));
    setLoadingStates(prev => ({ ...prev, [type]: false }));
  };

  return (
    <div style={{ padding: '20px' }}>
      <h1>Loading System Examples</h1>

      {/* Button Loading */}
      <section style={{ marginBottom: '40px', padding: '20px', border: '1px solid #ddd', borderRadius: '8px' }}>
        <h2>Button Loading</h2>
        <button
          onClick={() => simulateApiCall('button')}
          disabled={loadingStates.button}
          style={{
            padding: '10px 20px',
            backgroundColor: '#007bff',
            color: 'white',
            border: 'none',
            borderRadius: '4px',
            cursor: loadingStates.button ? 'not-allowed' : 'pointer',
            display: 'flex',
            alignItems: 'center',
            gap: '10px'
          }}
        >
          {loadingStates.button && <ClipLoader color="white" size={20} />}
          {loadingStates.button ? 'Loading...' : 'Submit'}
        </button>
      </section>

      {/* Inline Loading */}
      <section style={{ marginBottom: '40px', padding: '20px', border: '1px solid #ddd', borderRadius: '8px' }}>
        <h2>Inline Loading</h2>
        <button
          onClick={() => simulateApiCall('inline')}
          style={{
            padding: '10px 20px',
            backgroundColor: '#28a745',
            color: 'white',
            border: 'none',
            borderRadius: '4px',
            cursor: 'pointer',
            marginBottom: '20px'
          }}
        >
          Load Data
        </button>
        {loadingStates.inline ? (
          <div style={{ display: 'flex', justifyContent: 'center', padding: '20px' }}>
            <HashLoader color="#007bff" size={40} />
          </div>
        ) : (
          <div style={{ padding: '20px', backgroundColor: '#f8f9fa', borderRadius: '4px' }}>
            <p>Data loaded successfully!</p>
          </div>
        )}
      </section>

      {/* Page Loading */}
      <section style={{ marginBottom: '40px', padding: '20px', border: '1px solid #ddd', borderRadius: '8px' }}>
        <h2>Page Loading</h2>
        <button
          onClick={() => simulateApiCall('page')}
          style={{
            padding: '10px 20px',
            backgroundColor: '#ffc107',
            color: 'black',
            border: 'none',
            borderRadius: '4px',
            cursor: 'pointer'
          }}
        >
          Load Page Content
        </button>
        {loadingStates.page && (
          <div style={{
            position: 'fixed',
            top: 0,
            left: 0,
            right: 0,
            bottom: 0,
            backgroundColor: 'rgba(255, 255, 255, 0.9)',
            display: 'flex',
            justifyContent: 'center',
            alignItems: 'center',
            zIndex: 1000
          }}>
            <div style={{ textAlign: 'center' }}>
              <PulseLoader color="#007bff" size={15} />
              <p style={{ marginTop: '20px', fontSize: '18px' }}>Loading page content...</p>
            </div>
          </div>
        )}
      </section>

      {/* Overlay Loading */}
      <section style={{ marginBottom: '40px', padding: '20px', border: '1px solid #ddd', borderRadius: '8px', position: 'relative' }}>
        <h2>Overlay Loading</h2>
        <button
          onClick={() => simulateApiCall('overlay')}
          style={{
            padding: '10px 20px',
            backgroundColor: '#dc3545',
            color: 'white',
            border: 'none',
            borderRadius: '4px',
            cursor: 'pointer'
          }}
        >
          Process Data
        </button>
        <div style={{
          padding: '20px',
          backgroundColor: '#f8f9fa',
          borderRadius: '4px',
          marginTop: '20px',
          minHeight: '200px'
        }}>
          <p>Content area that can be overlaid with a loading spinner.</p>
        </div>
        {loadingStates.overlay && (
          <div style={{
            position: 'absolute',
            top: 0,
            left: 0,
            right: 0,
            bottom: 0,
            backgroundColor: 'rgba(0, 0, 0, 0.5)',
            display: 'flex',
            justifyContent: 'center',
            alignItems: 'center',
            borderRadius: '8px'
          }}>
            <ScaleLoader color="#ffffff" />
          </div>
        )}
      </section>
    </div>
  );
}

export default LoadingSystem;

Now create a reusable loading component with CSS override:

// src/components/LoadingIndicator.jsx
import React from 'react';
import { ClipLoader } from 'react-spinners';

function LoadingIndicator({ size = 50, color = '#007bff', fullScreen = false, cssOverride = {} }) {
  const defaultCssOverride = {
    display: 'block',
    margin: '0 auto',
    ...cssOverride
  };

  if (fullScreen) {
    return (
      <div style={{
        position: 'fixed',
        top: 0,
        left: 0,
        right: 0,
        bottom: 0,
        backgroundColor: 'rgba(255, 255, 255, 0.9)',
        display: 'flex',
        justifyContent: 'center',
        alignItems: 'center',
        zIndex: 1000
      }}>
        <ClipLoader color={color} size={size} cssOverride={defaultCssOverride} />
      </div>
    );
  }

  return (
    <div style={{ display: 'flex', justifyContent: 'center', alignItems: 'center', padding: '20px' }}>
      <ClipLoader color={color} size={size} cssOverride={defaultCssOverride} />
    </div>
  );
}

export default LoadingIndicator;

Update your App.jsx:

// src/App.jsx
import React from 'react';
import LoadingSystem from './LoadingSystem';
import MultipleSpinnersExample from './MultipleSpinnersExample';
import './App.css';

function App() {
  return (
    <div className="App">
      <LoadingSystem />
      <MultipleSpinnersExample />
    </div>
  );
}

export default App;

This example demonstrates:

Multiple spinner types
Button loading states
Inline loading indicators
Page-level loading
Overlay loading
Customizable colors, sizes, and speeds
CSS override for advanced styling

Common Issues / Troubleshooting

Spinner not displaying: Make sure the loading prop is set to true (if using it) or the component is conditionally rendered. Also check that you're importing the correct spinner component.
Spinner too small or large: Adjust the size prop to control the spinner size. The size is in pixels.
Color not changing: Use the color prop to set the spinner color. It accepts any valid CSS color value (hex, rgb, named colors).
Animation too fast or slow: Use the speedMultiplier prop to adjust animation speed. Values less than 1 slow down, values greater than 1 speed up.
Styling conflicts: Use the cssOverride prop to override default styles. This is useful when you need to customize positioning or other CSS properties.
Multiple spinners: You can use multiple spinner instances on the same page. Each spinner manages its own state independently.

Next Steps

Now that you have an understanding of react-spinners:

Explore all available spinner types
Learn about advanced customization with cssOverride
Implement loading states in forms and data fetching
Add loading indicators to async operations
Create custom loading components
Learn about other loading libraries (react-loader-spinner, react-spinners-css)
Check the official repository: https://github.com/davidhu2000/react-spinners
Look for part 54 of this series for more advanced topics

Summary

You've successfully set up react-spinners in your React application and created loading indicators for buttons, inline content, page loading, and overlays. react-spinners provides a variety of spinner types with extensive customization options for professional loading indicators.

SEO Keywords

react-spinners
React loading spinner
react-spinners tutorial
React spinner component
react-spinners installation
React loading indicator
react-spinners example
React animated spinner
react-spinners setup
React spinner library
react-spinners customization
React spinner types
react-spinners cssOverride
React loading library
react-spinners getting started

Getting Started with React Spinners CSS: Building Loading Indicators

Joseph Nelson — Mon, 19 Jan 2026 17:08:55 +0000

React Spinners CSS is a lightweight library for creating CSS-animated loading spinners in React applications. It provides a collection of pure CSS spinners that are easy to use and customize, perfect for indicating loading states without JavaScript animations. This guide walks through setting up and creating loading spinners using React Spinners CSS with React, from installation to a working implementation. This is part 52 of a series on using React Spinners CSS with React.
https://bit.cloud/joshk/react-spinners-css

Prerequisites

Before you begin, make sure you have:

Node.js version 14.0 or higher installed
npm, yarn, or pnpm package manager
A React project (version 16.8 or higher) or create-react-app setup
Basic knowledge of React components
Familiarity with JavaScript/TypeScript
Understanding of CSS

Installation

Install React Spinners CSS using your preferred package manager:

npm install react-spinners-css

Or with yarn:

yarn add react-spinners-css

Or with pnpm:

pnpm add react-spinners-css

After installation, your package.json should include:

{
  "dependencies": {
    "react-spinners-css": "^1.0.0",
    "react": "^18.0.0",
    "react-dom": "^18.0.0"
  }
}

Project Setup

React Spinners CSS requires minimal setup. Import the spinner components and you're ready to use them.

First Example / Basic Usage

Let's create a simple loading spinner. Create a new file src/SpinnerExample.jsx:

// src/SpinnerExample.jsx
import React, { useState } from 'react';
import { Spinner } from 'react-spinners-css';

function SpinnerExample() {
  const [isLoading, setIsLoading] = useState(false);

  const handleLoad = async () => {
    setIsLoading(true);
    // Simulate API call
    await new Promise(resolve => setTimeout(resolve, 2000));
    setIsLoading(false);
  };

  return (
    <div style={{ padding: '20px', textAlign: 'center' }}>
      <h2>Loading Spinner Example</h2>
      <button
        onClick={handleLoad}
        disabled={isLoading}
        style={{
          padding: '10px 20px',
          backgroundColor: '#007bff',
          color: 'white',
          border: 'none',
          borderRadius: '4px',
          cursor: isLoading ? 'not-allowed' : 'pointer',
          marginBottom: '20px'
        }}
      >
        {isLoading ? 'Loading...' : 'Start Loading'}
      </button>
      {isLoading && (
        <div style={{ display: 'flex', justifyContent: 'center', alignItems: 'center' }}>
          <Spinner color="#007bff" />
        </div>
      )}
    </div>
  );
}

export default SpinnerExample;

Update your App.jsx:

// src/App.jsx
import React from 'react';
import SpinnerExample from './SpinnerExample';
import './App.css';

function App() {
  return (
    <div className="App">
      <SpinnerExample />
    </div>
  );
}

export default App;

This creates a loading spinner that appears when the button is clicked and disappears after the async operation completes.

Understanding the Basics

React Spinners CSS provides several spinner types:

Spinner: Basic spinner
Circle: Circle spinner
Bounce: Bouncing dots
Pulse: Pulsing animation
Wave: Wave animation
Rotate: Rotating spinner
And more CSS-based spinners

Key concepts:

CSS Animations: All spinners use pure CSS animations for performance
Simple API: Easy to use with minimal configuration
Customization: Color and size can be customized
Lightweight: No JavaScript animations, just CSS
Conditional Rendering: Show/hide spinners based on loading state

Here's an example with different spinner types:

// src/MultipleSpinnersExample.jsx
import React, { useState } from 'react';
import { Spinner, Circle, Bounce, Pulse, Wave } from 'react-spinners-css';

function MultipleSpinnersExample() {
  const [selectedSpinner, setSelectedSpinner] = useState('Spinner');

  const spinners = {
    Spinner: <Spinner color="#007bff" />,
    Circle: <Circle color="#28a745" />,
    Bounce: <Bounce color="#ffc107" />,
    Pulse: <Pulse color="#dc3545" />,
    Wave: <Wave color="#6c757d" />
  };

  return (
    <div style={{ padding: '20px', textAlign: 'center' }}>
      <h2>Multiple Spinner Types</h2>
      <div style={{ marginBottom: '20px' }}>
        <label>Select Spinner: </label>
        <select
          value={selectedSpinner}
          onChange={(e) => setSelectedSpinner(e.target.value)}
          style={{ padding: '5px', marginLeft: '10px' }}
        >
          {Object.keys(spinners).map(type => (
            <option key={type} value={type}>{type}</option>
          ))}
        </select>
      </div>
      <div style={{ display: 'flex', justifyContent: 'center', alignItems: 'center', minHeight: '200px' }}>
        {spinners[selectedSpinner]}
      </div>
    </div>
  );
}

export default MultipleSpinnersExample;

Practical Example / Building Something Real

Let's build a comprehensive loading system with different spinner types and use cases:

// src/LoadingSystem.jsx
import React, { useState } from 'react';
import { Spinner, Circle, Bounce, Pulse } from 'react-spinners-css';

function LoadingSystem() {
  const [loadingStates, setLoadingStates] = useState({
    button: false,
    inline: false,
    page: false,
    overlay: false
  });

  const simulateApiCall = async (type) => {
    setLoadingStates(prev => ({ ...prev, [type]: true }));
    await new Promise(resolve => setTimeout(resolve, 2000));
    setLoadingStates(prev => ({ ...prev, [type]: false }));
  };

  return (
    <div style={{ padding: '20px' }}>
      <h1>Loading System Examples</h1>

      {/* Button Loading */}
      <section style={{ marginBottom: '40px', padding: '20px', border: '1px solid #ddd', borderRadius: '8px' }}>
        <h2>Button Loading</h2>
        <button
          onClick={() => simulateApiCall('button')}
          disabled={loadingStates.button}
          style={{
            padding: '10px 20px',
            backgroundColor: '#007bff',
            color: 'white',
            border: 'none',
            borderRadius: '4px',
            cursor: loadingStates.button ? 'not-allowed' : 'pointer',
            display: 'flex',
            alignItems: 'center',
            gap: '10px'
          }}
        >
          {loadingStates.button && <Spinner color="white" size={20} />}
          {loadingStates.button ? 'Loading...' : 'Submit'}
        </button>
      </section>

      {/* Inline Loading */}
      <section style={{ marginBottom: '40px', padding: '20px', border: '1px solid #ddd', borderRadius: '8px' }}>
        <h2>Inline Loading</h2>
        <button
          onClick={() => simulateApiCall('inline')}
          style={{
            padding: '10px 20px',
            backgroundColor: '#28a745',
            color: 'white',
            border: 'none',
            borderRadius: '4px',
            cursor: 'pointer',
            marginBottom: '20px'
          }}
        >
          Load Data
        </button>
        {loadingStates.inline ? (
          <div style={{ display: 'flex', justifyContent: 'center', padding: '20px' }}>
            <Circle color="#007bff" />
          </div>
        ) : (
          <div style={{ padding: '20px', backgroundColor: '#f8f9fa', borderRadius: '4px' }}>
            <p>Data loaded successfully!</p>
          </div>
        )}
      </section>

      {/* Page Loading */}
      <section style={{ marginBottom: '40px', padding: '20px', border: '1px solid #ddd', borderRadius: '8px' }}>
        <h2>Page Loading</h2>
        <button
          onClick={() => simulateApiCall('page')}
          style={{
            padding: '10px 20px',
            backgroundColor: '#ffc107',
            color: 'black',
            border: 'none',
            borderRadius: '4px',
            cursor: 'pointer'
          }}
        >
          Load Page Content
        </button>
        {loadingStates.page && (
          <div style={{
            position: 'fixed',
            top: 0,
            left: 0,
            right: 0,
            bottom: 0,
            backgroundColor: 'rgba(255, 255, 255, 0.9)',
            display: 'flex',
            justifyContent: 'center',
            alignItems: 'center',
            zIndex: 1000
          }}>
            <div style={{ textAlign: 'center' }}>
              <Pulse color="#007bff" size={60} />
              <p style={{ marginTop: '20px', fontSize: '18px' }}>Loading page content...</p>
            </div>
          </div>
        )}
      </section>

      {/* Overlay Loading */}
      <section style={{ marginBottom: '40px', padding: '20px', border: '1px solid #ddd', borderRadius: '8px', position: 'relative' }}>
        <h2>Overlay Loading</h2>
        <button
          onClick={() => simulateApiCall('overlay')}
          style={{
            padding: '10px 20px',
            backgroundColor: '#dc3545',
            color: 'white',
            border: 'none',
            borderRadius: '4px',
            cursor: 'pointer'
          }}
        >
          Process Data
        </button>
        <div style={{
          padding: '20px',
          backgroundColor: '#f8f9fa',
          borderRadius: '4px',
          marginTop: '20px',
          minHeight: '200px'
        }}>
          <p>Content area that can be overlaid with a loading spinner.</p>
        </div>
        {loadingStates.overlay && (
          <div style={{
            position: 'absolute',
            top: 0,
            left: 0,
            right: 0,
            bottom: 0,
            backgroundColor: 'rgba(0, 0, 0, 0.5)',
            display: 'flex',
            justifyContent: 'center',
            alignItems: 'center',
            borderRadius: '8px'
          }}>
            <Bounce color="#ffffff" />
          </div>
        )}
      </section>
    </div>
  );
}

export default LoadingSystem;

Now create a reusable loading component:

// src/components/LoadingIndicator.jsx
import React from 'react';
import { Spinner } from 'react-spinners-css';

function LoadingIndicator({ size = 50, color = '#007bff', fullScreen = false }) {
  if (fullScreen) {
    return (
      <div style={{
        position: 'fixed',
        top: 0,
        left: 0,
        right: 0,
        bottom: 0,
        backgroundColor: 'rgba(255, 255, 255, 0.9)',
        display: 'flex',
        justifyContent: 'center',
        alignItems: 'center',
        zIndex: 1000
      }}>
        <Spinner color={color} size={size} />
      </div>
    );
  }

  return (
    <div style={{ display: 'flex', justifyContent: 'center', alignItems: 'center', padding: '20px' }}>
      <Spinner color={color} size={size} />
    </div>
  );
}

export default LoadingIndicator;

Update your App.jsx:

// src/App.jsx
import React from 'react';
import LoadingSystem from './LoadingSystem';
import './App.css';

function App() {
  return (
    <div className="App">
      <LoadingSystem />
    </div>
  );
}

export default App;

This example demonstrates:

Multiple spinner types
Button loading states
Inline loading indicators
Page-level loading
Overlay loading
Reusable loading component
Custom sizing and colors

Common Issues / Troubleshooting

Spinner not displaying: Make sure you're importing the correct spinner component. Each spinner type is a separate component that needs to be imported individually.
Spinner too small or large: Use the size prop to control the spinner size. Not all spinners support the size prop, so check the documentation for your specific spinner type.
Color not changing: Use the color prop to set the spinner color. It accepts any valid CSS color value (hex, rgb, named colors).
Spinner not animating: React Spinners CSS uses pure CSS animations. If the spinner isn't animating, check for CSS conflicts or ensure the component is properly rendered.
Multiple spinners: You can use multiple spinner instances on the same page. Each spinner manages its own state independently.
Performance: Since spinners use CSS animations, they're very performant. However, if you have many spinners, consider using conditional rendering to only show them when needed.

Next Steps

Now that you have a basic understanding of React Spinners CSS:

Explore all available spinner types
Learn about advanced customization options
Implement loading states in forms and data fetching
Add loading indicators to async operations
Create custom loading components
Learn about other loading libraries (react-loader-spinner, react-spinners)
Check the official repository: https://github.com/JoshK2/react-spinners-css
Look for part 53 of this series for more advanced topics

Summary

You've successfully set up React Spinners CSS in your React application and created loading indicators for buttons, inline content, page loading, and overlays. React Spinners CSS provides lightweight, CSS-animated spinners that are easy to use and customize.

SEO Keywords

react-spinners-css
React CSS spinner
react-spinners-css tutorial
React loading indicator
react-spinners-css installation
React CSS animation spinner
react-spinners-css example
React pure CSS spinner
react-spinners-css setup
React lightweight spinner
react-spinners-css customization
React spinner component
react-spinners-css types
React loading library
react-spinners-css getting started

Advanced Loading Bar System with react-redux-loading-bar in React

Joseph Nelson — Mon, 19 Jan 2026 17:07:10 +0000

react-redux-loading-bar is a Redux-based loading bar component for React applications. It provides a top-loading bar that automatically shows progress for async operations managed through Redux actions, making it ideal for applications using Redux for state management. This guide walks through advanced usage of react-redux-loading-bar with React and Redux, including middleware integration, custom configurations, and complex loading patterns. This is part 51 of a series on using react-redux-loading-bar with React.

Prerequisites

Before you begin, make sure you have:

Node.js version 14.0 or higher installed
npm, yarn, or pnpm package manager
A React project (version 16.8 or higher) or create-react-app setup
Redux and React-Redux installed and configured
Basic knowledge of Redux (actions, reducers, middleware)
Understanding of React hooks (useSelector, useDispatch)
Familiarity with async operations and Redux middleware

Installation

Install react-redux-loading-bar and Redux dependencies:

npm install react-redux-loading-bar react-redux redux

Or with yarn:

yarn add react-redux-loading-bar react-redux redux

Or with pnpm:

pnpm add react-redux-loading-bar react-redux redux

After installation, your package.json should include:

{
  "dependencies": {
    "react-redux-loading-bar": "^5.0.0",
    "react-redux": "^8.0.0",
    "redux": "^4.0.0",
    "react": "^18.0.0",
    "react-dom": "^18.0.0"
  }
}

Project Setup

Set up Redux store with loading bar reducer and middleware. First, create the Redux store:

// src/store/index.js
import { createStore, combineReducers, applyMiddleware } from 'redux';
import { loadingBarReducer } from 'react-redux-loading-bar';
import thunk from 'redux-thunk';

const rootReducer = combineReducers({
  loadingBar: loadingBarReducer
});

export const store = createStore(
  rootReducer,
  applyMiddleware(thunk)
);

Now set up the provider and loading bar component:

// src/index.js
import React from 'react';
import ReactDOM from 'react-dom/client';
import { Provider } from 'react-redux';
import { store } from './store';
import LoadingBar from 'react-redux-loading-bar';
import App from './App';

const root = ReactDOM.createRoot(document.getElementById('root'));
root.render(
  <React.StrictMode>
    <Provider store={store}>
      <LoadingBar />
      <App />
    </Provider>
  </React.StrictMode>
);

First Example / Basic Usage

Let's create a simple loading bar example. Create a new file src/LoadingBarExample.jsx:

// src/LoadingBarExample.jsx
import React from 'react';
import { useDispatch } from 'react-redux';
import { showLoading, hideLoading } from 'react-redux-loading-bar';

function LoadingBarExample() {
  const dispatch = useDispatch();

  const handleLoad = async () => {
    dispatch(showLoading());
    try {
      // Simulate API call
      await new Promise(resolve => setTimeout(resolve, 2000));
    } finally {
      dispatch(hideLoading());
    }
  };

  return (
    <div style={{ padding: '20px' }}>
      <h2>Loading Bar Example</h2>
      <button
        onClick={handleLoad}
        style={{
          padding: '10px 20px',
          backgroundColor: '#007bff',
          color: 'white',
          border: 'none',
          borderRadius: '4px',
          cursor: 'pointer'
        }}
      >
        Start Loading
      </button>
    </div>
  );
}

export default LoadingBarExample;

Update your App.jsx:

// src/App.jsx
import React from 'react';
import LoadingBarExample from './LoadingBarExample';
import './App.css';

function App() {
  return (
    <div className="App">
      <LoadingBarExample />
    </div>
  );
}

export default App;

Understanding the Basics

react-redux-loading-bar uses Redux for state management:

loadingBarReducer: Redux reducer that manages loading state
showLoading action: Dispatches to show the loading bar
hideLoading action: Dispatches to hide the loading bar
LoadingBar component: Renders the loading bar UI
Middleware integration: Can integrate with Redux middleware for automatic loading

Key concepts for advanced usage:

Redux Integration: Loading state is managed through Redux store
Action Dispatching: Use showLoading and hideLoading actions
Middleware: Integrate with Redux middleware for automatic loading bar management
Multiple Requests: Handles multiple concurrent requests
Customization: Styling and behavior can be customized

Here's an example with middleware integration:

// src/store/index.js
import { createStore, combineReducers, applyMiddleware } from 'redux';
import { loadingBarReducer } from 'react-redux-loading-bar';
import thunk from 'redux-thunk';

// Custom middleware for automatic loading bar
const loadingBarMiddleware = store => next => action => {
  if (action.type.endsWith('_PENDING')) {
    store.dispatch({ type: 'SHOW_LOADING_BAR' });
  } else if (action.type.endsWith('_FULFILLED') || action.type.endsWith('_REJECTED')) {
    store.dispatch({ type: 'HIDE_LOADING_BAR' });
  }
  return next(action);
};

const rootReducer = combineReducers({
  loadingBar: loadingBarReducer
});

export const store = createStore(
  rootReducer,
  applyMiddleware(thunk, loadingBarMiddleware)
);

Practical Example / Building Something Real

Let's build a comprehensive loading system with Redux actions and middleware:

// src/actions/loadingActions.js
import { showLoading, hideLoading } from 'react-redux-loading-bar';

export const startLoading = () => (dispatch) => {
  dispatch(showLoading());
};

export const stopLoading = () => (dispatch) => {
  dispatch(hideLoading());
};

export const fetchData = () => async (dispatch) => {
  dispatch(showLoading());
  try {
    const response = await fetch('https://api.example.com/data');
    const data = await response.json();
    dispatch({ type: 'FETCH_DATA_SUCCESS', payload: data });
    return data;
  } catch (error) {
    dispatch({ type: 'FETCH_DATA_ERROR', payload: error.message });
    throw error;
  } finally {
    dispatch(hideLoading());
  }
};

Create a component that uses the loading bar:

// src/AdvancedLoadingSystem.jsx
import React, { useState } from 'react';
import { useDispatch, useSelector } from 'react-redux';
import { showLoading, hideLoading } from 'react-redux-loading-bar';
import LoadingBar from 'react-redux-loading-bar';

function AdvancedLoadingSystem() {
  const dispatch = useDispatch();
  const [data, setData] = useState(null);
  const [error, setError] = useState(null);

  const handleSingleRequest = async () => {
    dispatch(showLoading());
    try {
      await new Promise(resolve => setTimeout(resolve, 2000));
      setData('Single request completed');
    } catch (err) {
      setError(err.message);
    } finally {
      dispatch(hideLoading());
    }
  };

  const handleMultipleRequests = async () => {
    dispatch(showLoading());
    try {
      // Simulate multiple concurrent requests
      await Promise.all([
        new Promise(resolve => setTimeout(resolve, 1000)),
        new Promise(resolve => setTimeout(resolve, 1500)),
        new Promise(resolve => setTimeout(resolve, 2000))
      ]);
      setData('Multiple requests completed');
    } catch (err) {
      setError(err.message);
    } finally {
      dispatch(hideLoading());
    }
  };

  const handleSequentialRequests = async () => {
    dispatch(showLoading());
    try {
      await new Promise(resolve => setTimeout(resolve, 1000));
      await new Promise(resolve => setTimeout(resolve, 1000));
      await new Promise(resolve => setTimeout(resolve, 1000));
      setData('Sequential requests completed');
    } catch (err) {
      setError(err.message);
    } finally {
      dispatch(hideLoading());
    }
  };

  return (
    <div style={{ padding: '20px' }}>
      <LoadingBar
        style={{
          backgroundColor: '#007bff',
          height: '3px',
          zIndex: 9999
        }}
        showFastActions
      />
      <h1>Advanced Loading System</h1>
      <div style={{ display: 'flex', flexDirection: 'column', gap: '10px', maxWidth: '400px' }}>
        <button
          onClick={handleSingleRequest}
          style={{
            padding: '10px 20px',
            backgroundColor: '#007bff',
            color: 'white',
            border: 'none',
            borderRadius: '4px',
            cursor: 'pointer'
          }}
        >
          Single Request
        </button>
        <button
          onClick={handleMultipleRequests}
          style={{
            padding: '10px 20px',
            backgroundColor: '#28a745',
            color: 'white',
            border: 'none',
            borderRadius: '4px',
            cursor: 'pointer'
          }}
        >
          Multiple Requests
        </button>
        <button
          onClick={handleSequentialRequests}
          style={{
            padding: '10px 20px',
            backgroundColor: '#ffc107',
            color: 'black',
            border: 'none',
            borderRadius: '4px',
            cursor: 'pointer'
          }}
        >
          Sequential Requests
        </button>
      </div>
      {data && (
        <div style={{
          marginTop: '20px',
          padding: '15px',
          backgroundColor: '#d4edda',
          color: '#155724',
          borderRadius: '4px'
        }}>
          {data}
        </div>
      )}
      {error && (
        <div style={{
          marginTop: '20px',
          padding: '15px',
          backgroundColor: '#f8d7da',
          color: '#721c24',
          borderRadius: '4px'
        }}>
          Error: {error}
        </div>
      )}
    </div>
  );
}

export default AdvancedLoadingSystem;

Create a custom hook for loading management:

// src/hooks/useLoadingBar.js
import { useCallback } from 'react';
import { useDispatch } from 'react-redux';
import { showLoading, hideLoading } from 'react-redux-loading-bar';

export const useLoadingBar = () => {
  const dispatch = useDispatch();

  const withLoading = useCallback(async (asyncFn) => {
    dispatch(showLoading());
    try {
      const result = await asyncFn();
      return result;
    } finally {
      dispatch(hideLoading());
    }
  }, [dispatch]);

  const startLoading = useCallback(() => {
    dispatch(showLoading());
  }, [dispatch]);

  const stopLoading = useCallback(() => {
    dispatch(hideLoading());
  }, [dispatch]);

  return {
    withLoading,
    startLoading,
    stopLoading
  };
};

Update your store with proper configuration:

// src/store/index.js
import { createStore, combineReducers, applyMiddleware } from 'redux';
import { loadingBarReducer } from 'react-redux-loading-bar';
import thunk from 'redux-thunk';

const rootReducer = combineReducers({
  loadingBar: loadingBarReducer
});

export const store = createStore(
  rootReducer,
  applyMiddleware(thunk)
);

Update your App.jsx:

// src/App.jsx
import React from 'react';
import AdvancedLoadingSystem from './AdvancedLoadingSystem';
import './App.css';

function App() {
  return (
    <div className="App">
      <AdvancedLoadingSystem />
    </div>
  );
}

export default App;

This example demonstrates:

Redux-based loading bar
Single and multiple request handling
Sequential request management
Custom loading hook
Error handling with loading bar
Custom styling

Common Issues / Troubleshooting

Loading bar not appearing: Ensure LoadingBar component is rendered in your app and loadingBarReducer is added to your Redux store. Also make sure you're dispatching showLoading actions.
Redux store not configured: Make sure you've added the loadingBarReducer to your Redux store using combineReducers. The reducer must be named loadingBar.
Actions not working: Ensure you're using useDispatch from react-redux to dispatch actions. Import showLoading and hideLoading from react-redux-loading-bar.
Loading bar not hiding: Make sure you're calling hideLoading() in a finally block or after the async operation completes. If an error occurs, the loading bar should still be hidden.
Multiple requests: react-redux-loading-bar handles multiple concurrent requests automatically. It shows the bar when any request starts and hides it when all requests complete.
Styling issues: Use the style prop on the LoadingBar component to customize appearance. You can set backgroundColor, height, zIndex, and other CSS properties.

Next Steps

Now that you have an advanced understanding of react-redux-loading-bar:

Explore middleware integration for automatic loading
Learn about custom loading bar configurations
Implement loading bar with Redux Saga
Add loading bar to API interceptors
Integrate with React Router for route-based loading
Learn about other loading bar libraries
Check the official repository: https://github.com/mironov/react-redux-loading-bar
Look for part 52 of this series for more advanced topics

Summary

You've successfully integrated react-redux-loading-bar into your React application with Redux for advanced loading bar management. react-redux-loading-bar provides a Redux-based solution for displaying loading progress with automatic handling of multiple concurrent requests.

SEO Keywords

react-redux-loading-bar
React Redux loading bar
react-redux-loading-bar tutorial
React loading indicator
react-redux-loading-bar installation
React Redux loading
react-redux-loading-bar example
React progress bar
react-redux-loading-bar setup
React Redux middleware
react-redux-loading-bar customization
React loading state
react-redux-loading-bar actions
React Redux library
react-redux-loading-bar getting started