[SURVEY RESULTS] The 2024 edition of State of Software Modernization market report is published!
GET IT here

How We Built React Carousel [A Step by Step Guide]

Last updated on
August 29, 2023



How We Built React Carousel [A Step by Step Guide]


At Brainhub, for the most part, we use React JS to build our user interfaces.

The growing size of the library’s ecosystem gives React developers a greater variety of existing open-source components. On top of that, thanks to React’s modularity and focus on component reusability, we can utilize components between different projects.

Carousel components are a staple in many applications, and no wonder — they are a great way to draw focus to images without overwhelming the user or cluttering the page. Unfortunately, already existing React carousel components had issues that made them unsuitable for our purposes.

This resulted in essentially having to reinvent the wheel in every project and building a carousel from scratch or using inferior solutions for a relatively simple problem.

Building our own React carousel

We wanted a React carousel that did not depend on any large external libraries (such as jQuery) and was extensible and lightweight.

We also needed it to be customizable enough to fit the large number of applications we worked on, but simultaneously good enough out of the box that we did not need to worry about reinventing the wheel.

Failing to find a React carousel like that in the existing ecosystem, we decided to create our own.

The main objectives when building react-carousel were to:

  • Avoid using external libraries — we focused on making the carousel as lightweight and fast as possible (at the time of writing it is only 11KB gzipped).
  • Allow for maximum pluggability — we want to let the user replace existing parts of the carousel if he or she so chooses without hassle.
  • Provide sensible defaults — our React carousel should be usable and pretty right out of the box.

Managing complexity

The best React carousel library.

The core of react-carousel deals exclusively with controlling whatever is inside. That is, essentially, everything you see — images, arrows — can be switched out for custom components and linked to the carousel with minimal effort.

This is the entire code driving the React carousel in the gif above.

You will notice that the React carousel works just by wrapping any number of React components into a "Carousel" component. "Carousel" itself takes a number of props which deal with its behavior (you can see the full list of available options in the docs).

A common design pattern in react-carousel is to expose API with different levels of complexity, depending on how much customization is required. For instance, if the user wishes to add arrows to a newly created bare carousel, he or she can add the boolean arrows prop that will render the default arrows.

However, if a greater level of customization is desired, the user can instead add arrowLeft and arrowRight props. Each of them takes a React component that will determine the appearance of the arrows.

Aside from the arrows, there are many more aspects of the carousel that can be modified this way – such as dots showing the position of the carousel, thumbnails, draggability, number of carousel slides per page and more.

Controlled component

Another helpful property of react-carousel is that you can use it as a fully controlled component – meaning you can control it from the parent component through props rather than solely through user input.

This means you can use the full power of React to interact with it from other places in your app or, if necessary, couple it with other React libraries like Redux to make your carousel even more powerful.

Of course, using the carousel as a controlled component is entirely optional and you can still just throw a few slides at it without any props and it still is going to work.

React carousel under the hood

Beyond giving the user many options for customization, react-carousel does several things which ensure good performance and usability right out of the box.

First, all the movement in the carousel is implemented using smooth CSS animations. We put in a lot of effort to ensure that we cover special cases and do not compromise on good appearance. Events like scrolling by multiple slides are made to look to impress.

On top of that, we made sure that the carousel is fully responsive and renders well on any device and any screen size. The carousel always resizes itself to the largest available width and looks great on mobile, tablet and desktop. This is complemented by smooth touch controls.


We are pretty sure this is the best React carousel available but don’t take our word for it. Feel free to check it out yourself on GitHub and let us know how it works for you.

Frequently Asked Questions

No items found.

Our promise

Every year, Brainhub helps 750,000+ founders, leaders and software engineers make smart tech decisions. We earn that trust by openly sharing our insights based on practical software engineering experience.


Marcin Dryka
Software Engineer

Full-stack software developer with 17 years of professional experience.

Bianka Pluszczewska
Tech Editor

Software development enthusiast with 8 years of professional experience in this industry.

Get smarter in engineering and leadership in less than 60 seconds.

Join 300+ founders and engineering leaders, and get a weekly newsletter that takes our CEO 5-6 hours to prepare.

Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.