/componentkit

A React-inspired view framework for iOS.

Primary LanguageObjective-C++OtherNOASSERTION

ComponentKit

Build Status

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.

Quick start

ComponentKit is available to install via CocoaPods or Carthage.

If you are using CocoaPods, add the following to your Podfile:

pod 'ComponentKit', '~> 0.14'

If you are using Carthage, add the following to your Cartfile:

github "facebook/ComponentKit" ~> 0.14

Opening the Xcode projects

If you want to try out ComponentKit just clone the GitHub repository and open the Xcode project. 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

There is no need to run any special commands prior to opening either Xcode project.

Learn more

Contributing

See the CONTRIBUTING file for how to help out.

License

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.