npm i react-gm3carousel
bun i react-gm3carousel
...

 import { GM3Carousel } from "react-gm3carousel";
 // below could be optional, if you're already using TailwindCSS in your project, but you should add it regardless
 import "react-gm3carousel/dist/index.css";

Ensure your carousel is wrapped in an element with set width/height otherwise it ain't gonna show.

<div  style={{ width:  600, height:  240, background:  "red" }}>
	<GM3Carousel
		perPage={4}
		speedS={2}
		slides={DATA.map((d, idx) => ({
		content:  <p>Slide {idx}</p>,
		key:  d.id,
		}))}
	/>
</div>

{
	// vertical vs horizontal carousel
	isVertical?: boolean;

	// wrapper class name
	className?: string;

	// what to render inside each slide
	slides: { content: ReactNode; key: string }[];

	speedS: number;

	// how moany slide to render per page
	perPage: number;

	// will have 4 small previews vs 2
	withDualSmallItems?: boolean;

	// class name for wrapper of small items
	smallItemClassName?: string;

	// class name for wrapper of large items
	bigItemClassName?: string;

	// auto scroll pause
	isPaused?: boolean;

	pauseOnMouseEnter?: boolean;

	slideWrapperClassName?: string;
}

You can target active slides with the blow selector

[data-active="true"] {}

You can set a gap either by

gap={16}

or through class names (notice first/last child margins match the gap)

gap-2 [&>*:last-child]:-ml-2 [&>*:first-child]:-mr-2

The number of slideItems should be > than the perPage + 2, otherwise the transition animations might not work properly as there will be duplicate render issues due to React and how it might mess up tracking these items since the key will be duplicated.

More about the official spec:

https://m3.material.io/components/carousel/specs