ComposeCarouselLib

A lightweight and customizable image carousel slider built with Jetpack Compose, designed for Android apps. This library provides smooth animations, scaling transitions, and dot indicators to showcase images in a modern and beautiful way.

---

✨ Features

• Smooth scaling transition between carousel pages
• Support multiple data types URL, ResId, ImageBitmap and Painter
• AutoScroll customizable with Animtion
• Fully customizable dot indicators
• Clean and minimal design

---

📦 Installation

Add JitPack to your root build.gradle:

allprojects {
    repositories {
        maven { url 'https://jitpack.io' }
    }
}

Then, add the dependency in your module's build.gradle:

dependencies {
    implementation 'com.github.Ali0092:ComposeCarouselSlider:v1.0.2'
}

---

🛠️ Usage

ComposeCarouselSlider(
    modifier = Modifier.padding(vertical = 12.dp),
    height = 600.dp,
    sidePadding = 40.dp,
    pageSpacing = 0.dp,
    imageCornerRoundness = 1.dp,
    nonSelectedDotColor = Color.Gray,
    selectedDotColor = Color.DarkGray,
    enableAutoScroll = true,
    autoScrollDelay = 1200,
    enableAnimationOnAutoScroll = true,
    animationSpecs = spring(
        dampingRatio = Spring.DampingRatioMediumBouncy, stiffness = Spring.StiffnessLow
    ),
    imagesList = dataList,
    getOnClick = { index ->
        //index of clicked image
    }
)

---

⚙️ Parameters

Name	Type	Description
modifier	Modifier	Layout modifier for the carousel
height	Dp	Height of each carousel image card
sidePadding	Dp	Padding around the horizontal pager
pageSpacing	Dp	Space between each page (default: 8.dp)
imageCornerRoundness	Dp	Corner radius for image cards (default: 8.dp)
imagesList	List<CarouselImage>	List of images to display in the carousel
useDotIndicator	Boolean	Whether to show dot indicators (default: true)
nonSelectedDotColor	Color	Color of unselected dot indicators
selectedDotColor	Color	Color of the selected dot indicator
enableAutoScroll	Boolean	Automatically scroll to the next image (default: false)
autoScrollDelay	Long	Delay time in milliseconds for auto scroll (default: 3_000L)
enableAnimationOnAutoScroll	Boolean	Whether to animate the transition on auto scroll (default: false)
animationSpecs	AnimationSpec<Float>	Animation spec used when auto-scrolling (default: spring())
getOnClick	(Int) -> Unit	Callback when an image is clicked; provides index of clicked item

---

📸 Preview

---

📄 License

This project is licensed under the Apache License 2.0.

---

🤝 Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

---

👤 Author

Muhammad Ali 📧 aliatwork364@gmail.com 🔗 LinkedIn 🐙 GitHub