gitwtfhub

wtf is fspagerview?

wenchaod/fspagerview — explained in plain English

Analysis updated 2026-06-24

7,369SwiftAudience · developerComplexity · 2/5Setup · easy

TL;DR

FSPagerView is a Swift library for iOS that adds a sliding image carousel or banner to your app, with built-in infinite scroll, auto-advance timer, eight visual transition styles, and customizable page indicator dots.

Mindmap

mindmap
  root((FSPagerView))
    What it does
      Image carousel
      Infinite scroll
      Auto slide timer
    Transitions
      Cross fade
      Depth zoom
      Ferris wheel
      Cover flow
    Page Indicator
      Dot colors
      Custom images
      Custom shape
    Setup
      CocoaPods
      Carthage
      Source files

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Add an auto-scrolling image banner to an iOS shopping or news app without building the paging logic yourself.

REASON 2

Apply visual slide transitions like Cover Flow or Ferris Wheel to a card carousel by setting a single property.

REASON 3

Build an onboarding screen with paging cards and custom dot indicators using code or Interface Builder.

REASON 4

Create an infinite-looping image carousel for an Apple TV app that never reaches a hard end.

What's in the stack?

SwiftObjective-CCocoaPodsCarthageXcode

How it stacks up

wenchaod/fspagerviewglushchenko/fsnotesmarcosgriselli/viewanimator
Stars7,3697,3607,329
LanguageSwiftSwiftSwift
Setup difficultyeasyeasyeasy
Complexity2/52/52/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 30min

Wtf does this do

FSPagerView is a Swift library for iOS developers who need to add a sliding card or banner component to an iPhone or Apple TV app. Think of the kind of image carousel you see at the top of many shopping apps, where photos automatically scroll sideways and dots at the bottom show which slide you are on. This library provides that kind of component, plus a range of visual transitions you can apply to make the sliding look more interesting. The library works by wrapping Apple's built-in collection view system, but handling the paging, animation, and infinite-scroll logic for you so you do not have to build it from scratch. You can configure it to slide automatically on a timer, loop infinitely so there is no hard end to the list, scroll horizontally or vertically, and control how far each swipe moves. Item sizes and the spacing between items are adjustable. For the visual transitions between slides, the README shows eight named styles with animated GIF previews: cross fading, zoom out, depth, linear, overlap, ferris wheel, inverted ferris wheel, cover flow, and cubic. You pick one by setting a single property. You can also create a custom transition by subclassing the transformer class the library provides. The page indicator dots at the bottom are also configurable. You can set the number of dots, change the colors for selected and unselected states, swap dots for custom images, or change the shape to any path you draw with code. Installation is available through CocoaPods, Carthage, or by copying the source files directly into an Xcode project. The library supports both Swift and Objective-C. The README includes step-by-step code examples and an explanation of how to connect the component using either code or Xcode's Interface Builder.

Yoink these prompts

Prompt 1
Using FSPagerView in Swift, write code to set up an auto-scrolling image carousel that loops infinitely with a 3-second timer.
Prompt 2
How do I apply the Cover Flow transition style to an FSPagerView in my iOS app?
Prompt 3
Write Swift code to replace FSPagerView's dot page indicators with custom images.
Prompt 4
Show me how to connect FSPagerView to a view controller using Xcode's Interface Builder instead of code.
Prompt 5
How do I subclass FSPagerViewTransformer to build a completely custom slide transition for FSPagerView?

Frequently asked questions

wtf is fspagerview?

FSPagerView is a Swift library for iOS that adds a sliding image carousel or banner to your app, with built-in infinite scroll, auto-advance timer, eight visual transition styles, and customizable page indicator dots.

What language is fspagerview written in?

Mainly Swift. The stack also includes Swift, Objective-C, CocoaPods.

How hard is fspagerview to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is fspagerview for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.