Latest 1.1.0
License MIT
Platforms ios 8.0
Dependencies KIF, Quick
Frameworks XCTest

Write KIF tests Quick style in Swift!

KIF-Quick is a bridge between the Keep It Functional and Quick frameworks. It allows you to perform KIF actions using Quick syntax. See wiki/Why-KIF-Quick



KIF-Quick is available through CocoaPods. To install it, simply add pod 'KIF-Quick' to your test target in Podfile:

target 'Your App' do

target 'Acceptance Tests' do
  pod 'KIF-Quick'

this will also install KIF and Quick frameworks as dependencies ensuring compatible versions.


import KIF_Quick in your specs and start writing KIF tests using Quick describe/context and it blocks. See the SampleSpec.m example:

import Quick
import KIF_Quick

class MainViewSpec: KIFSpec {
    override func spec() {
        describe("example app") {
            context("main view") {
                context("tap") {
                    it("should change to Thank you") {
                        viewTester().usingLabel("Tap Me").tap()
                        viewTester().usingLabel("Thank you!").waitForView()


To run the sample spec in example project, clone the repo, and open Example workspace:

open Example/KIF-Quick.xcworkspace

Select simulator and run tests as usual by pressing Command + U

Command Line

Run tests using xcodebuild:

xcodebuild -workspace Example/KIF-Quick.xcworkspace -scheme KIF-Quick-Example -sdk iphonesimulator -destination 'platform=iOS Simulator,name=iPhone 7,OS=10.2' ONLY_ACTIVE_ARCH=NO test

This is how Travis runs them to keep us honest, see .travis.yml

And you should see test output similar to this

▸ Test Succeeded
All tests
Test Suite KIF-Quick_Tests.xctest started
    ✓ example_app__main_view__should_have_a_button (0.003 seconds)
    ✓ example_app__main_view__tap__should_be_grateful (0.581 seconds)
     Executed 2 tests, with 0 failures (0 unexpected) in 0.584 (0.586) seconds

where nested Quick contexts concatenated to give full KIF test name. This allows to pinpoint location of possible failures when they happen and have readable English like sentenses describing the functionality.

Swift Version

If your project is still using Swift 2 you can can use previous version of KIF-Quick. Use the table below to determine which versions of KIF-Quick are compatible with your project.

Swift version KIF-Quick version Podfile usage git branch
Swift 3 v1.1.0 or later pod 'KIF-Quick' master
Swift 2.2 / Swift 2.3 v1.0.1 or later pod 'KIF-Quick', '~> 1.0.0' swift2.3

or you can specify this branch in your Podfile:

  pod 'KIF-Quick', :git => '', :branch => 'swift2.3'


Ian Luo


This project follows the all-contributors specification.
Contributions of any kind welcome!


Paul Zabelin


KIF-Quick is available under the MIT license. See the LICENSE file for more info.

Latest podspec

    "name": "KIF-Quick",
    "version": "1.1.0",
    "summary": "Enable Behaviour-Driven Integration Tests built on KIF using Quick syntax",
    "description": "Write Quick specs to drive KIF actors through user interface   * share common setup using spec contextn           * report XCTest failure with file name and line numbern           * install compatible versions of KIF and Quickn           * supports Swift 3.0, 2.3, 2.2",
    "homepage": "",
    "license": {
        "type": "MIT",
        "file": "LICENSE"
    "authors": {
        "Paul Zabelin": "[email protected]"
    "source": {
        "git": "",
        "tag": "1.1.0"
    "platforms": {
        "ios": "8.0"
    "source_files": "KIF-Quick/Classes",
    "frameworks": "XCTest",
    "dependencies": {
        "KIF": [
            "~> 3.0"
        "Quick": [
            "~> 1.0"
    "pushed_with_swift_version": "3.0"

Pin It on Pinterest

Share This