ComponentKit is a view framework for iOS that is heavily inspired by React. It takes a functional, declarative approach to building UI. It was built to power Facebook's News Feed and is now used throughout the Facebook iOS app.
ComponentKit is available to install via Carthage. To get started add the following to your Cartfile:
github "facebook/ComponentKit" ~> 0.25
ComponentKit has a few dependencies that need to be installed via Carthage. Before you open any of the Xcode projects in this repo, make sure you run:
carthage checkout
If Carthage isn't installed, you easily install it via Homebrew:
brew install carthage
If you can't use Homebrew, Carthage provides other installation methods.
To get started with the example app:
open Examples/WildeGuess/WildeGuess.xcodeproj
Build and run the WildeGuess target to try it out!
If you're interested in viewing only the ComponentKit source code in Xcode:
open ComponentKit.xcodeproj
- Read the Getting Started guide
- Get the sample projects
- Read the objc.io article by Adam Ernst
- Watch the @Scale talk by Ari Grant
See the CONTRIBUTING file for how to help out.
ComponentKit is BSD-licensed. We also provide an additional patent grant.
The files in the /Examples directory are licensed under a separate license as specified in each file; documentation is licensed CC-BY-4.0.