How does TimelineCards compare to building a timeline with UICollectionView?

TimelineCards abstracts timeline layout and card styling, offering built-in customization and feed management, whereas UICollectionView requires custom layout and cell design from scratch. However, UICollectionView provides more flexibility for non-standard or highly dynamic layouts that TimelineCards doesn't support, like horizontal scrolling.

How to add animations to TimelineCards when elements are tapped?

The library provides event handling delegates for taps, but animations are not built-in. You need to implement custom animations in the delegate methods, such as using UIView.animate or Core Animation, based on the tapped element index or view.

Does TimelineCards support SwiftUI?

No, TimelineCards is built for UIKit and does not have native SwiftUI support. To use it in SwiftUI projects, you must wrap it with UIViewControllerRepresentable, which adds complexity and may limit seamless integration with SwiftUI's declarative syntax.

Can I use TimelineCards with Objective-C?

Yes, but with limitations. Since it's a Swift library, you need to use bridging headers in Objective-C projects, and some Swift-specific features like optionals or advanced protocols might not be fully accessible or require additional work.

What's the performance impact of TimelineCards with thousands of timeline items?

The feed uses UITableView for efficient cell reuse, so it handles large datasets well in terms of memory. However, performance can degrade if custom UIView descriptions are complex or not optimized, as each item's view must be rendered within the containerWidth constraint.

How to update data dynamically in a TimelineCards feed?

To update data, call reloadData() on the TimelineFeed instance and ensure your data source provides the new elements. The library doesn't include built-in diffing or automatic animations for updates, so you may need to manage state changes manually for smooth transitions.

Open-Awesome

TimelineCards

MITSwift

A Swift library for presenting timelines as customizable cards, either individually or bundled into a scrollable feed.

GitHub

428 stars50 forks0 contributors

What is TimelineCards?

TimelineCards is a Swift library for iOS that generates timeline visualizations as customizable card-based UI components. It solves the problem of presenting ordered data, like events or milestones, in an attractive and interactive format, either as single cards or within a scrollable feed.

Target Audience

iOS developers building apps that need to display timelines, event histories, or sequential data in a visually engaging way, such as project management, educational, or news applications.

Value Proposition

Developers choose TimelineCards for its high customizability, memory-efficient feed implementation, and straightforward integration, allowing them to create professional timeline interfaces without building from scratch.

Overview

Presenting timelines as cards, single or bundled in scrollable feed!

Use Cases

Best For

Displaying event histories in iOS apps
Building project milestone trackers
Creating educational timelines for learning apps
Showing sequential data in news or content apps
Implementing interactive timelines in productivity tools
Adding visual timelines to portfolio or showcase apps

Not Ideal For

Projects requiring horizontal scrolling or paging for timelines
Apps needing advanced gesture interactions like 3D Touch or force-touch peek
Teams exclusively using SwiftUI or modern Swift versions (5.0+)
Developers wanting out-of-the-box animations or transitions without custom code

Pros & Cons

Pros

High Visual Customizability

Allows fine-tuning of every visual aspect, such as colors, borders, and milestone shapes, through properties like borderAppearance and itemShapeHeight, as demonstrated in the customization code snippets.

Flexible Data Integration

Supports both simple title/subtitle presets with attributed strings and fully custom UIView descriptions, enabling diverse data presentation for timeline items and groups.

Memory-Efficient Card Feeds

Uses UITableView internally for smooth scrolling and cell reuse, making it suitable for handling large datasets in feed mode without performance hits.

Comprehensive Event Handling

Provides clear delegate protocols for handling taps on all card elements, headers, and footers, enhancing interactivity with methods like didSelectElement and didTouchHeaderView.

Cons

Outdated Swift Support

Officially supports only Swift 3.2 and 4.0, which may cause compatibility issues and require extra work for integration into modern iOS projects using Swift 5.0 or later.

Missing Advanced Features

Lacks key functionalities like horizontal scrolling, additional milestone shapes (e.g., square, diamond), and force-touch interactions, as acknowledged in the TODO list of the README.

Custom View Complexity

Implementing custom UIView for item descriptions requires manual width management with containerWidth and layout, adding development overhead compared to simpler preset options.

Frequently Asked Questions

Related Projects

Koloda

KolodaView is a class designed to simplify the implementation of Tinder like cards on iOS.

Stars5,399

Forks808

Last commit1 year ago

Cards

Awesome iOS 11 appstore cards in swift 5.

Stars4,210

Forks273

Last commit3 years ago

MDCSwipeToChoose

Swipe to "like" or "dislike" any view, just like Tinder.app. Build a flashcard app, a photo viewer, and more, in minutes, not hours!

Stars2,543

Forks412

Last commit8 years ago

CardParts

A reactive, card-based UI framework built on UIKit for iOS developers.

Stars2,523

Forks222

Last commit4 years ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub