What is this?
IGListKit is a data-driven UICollectionView framework for building fast and flexible lists on iOS, built and maintained by Instagram engineering.
IGListKit is a data-driven UICollectionView framework for building fast and flexible lists on iOS, built and maintained by Instagram engineering.Is this a UIKit replacement or a layer on top of UICollectionView?It's a framework that sits on top of UICollectionView, handling diffing and batch updates so you don't manage reloadData() yourself; it's written in Objective-C with full Swift interop.
It's a framework that sits on top of UICollectionView, handling diffing and batch updates so you don't manage reloadData() yourself; it's written in Objective-C with full Swift interop.How do I add it to a project?Install it via CocoaPods (preferred), Carthage, or Swift Package Manager by adding the dependency to your Podfile, Cartfile, or Package.swift respectively.
Install it via CocoaPods (preferred), Carthage, or Swift Package Manager by adding the dependency to your Podfile, Cartfile, or Package.swift respectively.What are the minimum OS and Swift versions required?You need Swift 5.1+, iOS 11.0+ (tvOS 11.0+), with interoperability back to Swift 3.0+; macOS 10.13+ is only needed if you use the diffing algorithm components alone.
You need Swift 5.1+, iOS 11.0+ (tvOS 11.0+), with interoperability back to Swift 3.0+; macOS 10.13+ is only needed if you use the diffing algorithm components alone.Do I ever need to call performBatchUpdates or reloadData manually?No — the whole point of the library is that you never call performBatchUpdates(:, completion:) or reloadData() again; the diffing engine handles updates for you.
No — the whole point of the library is that you never call performBatchUpdates(:, completion:) or reloadData() again; the diffing engine handles updates for you.Does it only work on iPhone, or also on tvOS and Mac?It targets iOS and tvOS collection views; macOS support is limited to using just the diffing algorithm components, not the full UI framework.
It targets iOS and tvOS collection views; macOS support is limited to using just the diffing algorithm components, not the full UI framework.Is the license the same for the whole repo, including examples?The main library is MIT-licensed, but the files under /Examples/ use a separate license, and the documentation is licensed CC-BY-4.0.
The main library is MIT-licensed, but the files under /Examples/ use a separate license, and the documentation is licensed CC-BY-4.0.Can I mix different data types in one list?Yes, the framework is built to let you create collections combining multiple data types in a single list, using reusable cell/component sections.
Yes, the framework is built to let you create collections combining multiple data types in a single list, using reusable cell/component sections.Can I customize how diffing decides items changed?Yes, IGListKit lets you customize the diffing behavior for your own models, and the diffing algorithm itself is decoupled from the UI layer.
Yes, IGListKit lets you customize the diffing behavior for your own models, and the diffing algorithm itself is decoupled from the UI layer.Is this used in a real app or just a demo library?Instagram uses the open source main branch of IGListKit directly in the production Instagram app, syncing changes daily.
Instagram uses the open source main branch of IGListKit directly in the production Instagram app, syncing changes daily.Where can I see it in action?The repo includes sample apps in the Examples directory, plus a Getting Started guide and third-party tutorials like Ray Wenderlich's IGListKit walkthrough.
The repo includes sample apps in the Examples directory, plus a Getting Started guide and third-party tutorials like Ray Wenderlich's IGListKit walkthrough.What are similar projects?AFNetworking, FSCalendar, chameleon, DZNEmptyDataSet, Spring, SkeletonView, AsyncDisplayKit, folding-cell
AFNetworking, FSCalendar, chameleon, DZNEmptyDataSet, Spring, SkeletonView, AsyncDisplayKit, folding-cellWhich topics is it in?instagram, uikit, ui-library, objective-c, apple, swift, mobile, ios, performance, framework, gui, library
instagram, uikit, ui-library, objective-c, apple, swift, mobile, ios, performance, framework, gui, library