Kitura is a flexible and high-performance web framework that is designed for the cloud. We want to make it as easy as possible for users to build Kitura applications containing advanced features like built-in monitoring. So we’ve created the Kitura command-line interface to simplify the process and help you get your first app running quickly.

The Kitura command-line interface is installed on macOS through the Homebrew package manager. First, add the Swift@IBM tap to your system. This lets Homebrew access our Homebrew packages.

$ brew tap ibm-swift/kitura

Next, install the Kitura command-line interface. This will provide the kitura tool.

$ brew install kitura

Installing the Kitura command-line interface will also install required prerequisites. Once it’s finished you’ll be back at your command prompt. You can check the installation was successful by running the tool to see the usage information.

 $ kitura

  Usage: kitura [options] [command]

  Kitura command-line interface


  Options:

    -V, --version  output the version number
    -h, --help     output usage information


  Commands:

    build       build the project in a local container
    create      interactively create a Kitura project
    idt         install IBM Cloud Developer Tools
    init        scaffold a bare-bones Kitura project
    kit         download the KituraKit zip file
    run         run the project in a local container
    help [cmd]  display help for [cmd]

To get started quickly with Kitura, run the kitura init command. This will scaffold a basic Kitura project, and create a Dockerfile so you can build your application inside a Linux container.

For more flexibility, try the kitura create command instead. This will start an interactive question and answer tool where you can choose what type of Kitura application you want to create, and which features you’d like to include.

Once you’ve run kitura init or kitura create, you can open your application in Xcode by running open ApplicationName.xcodeproj. In Xcode it’s easy to build and run your Kitura application on macOS.

If you want to build your application in a Linux container as well, you’ll need to install the IBM Cloud Developer Tools (IDT) by running kitura idt. This will install Docker and other common cloud tools, so you’ll be ready to deploy your application to the cloud.

Once you’ve installed IDT, you can build your Kitura application in a Docker container on Linux by running kitura build, and run it in the container by running kitura run. This is a great way to test your application on Linux without the overhead of running a full Linux virtual machine on your Mac.

If you’re also building an iOS application to communicate with your Kitura server, have a look at KituraKit. This is a client library that makes it easy to interface with Kitura. You can download KituraKit from the command-line by running kitura kit. This will save a KituraKit.zip file to disk, which you can easily import into your iOS project in Xcode.

Leave a Reply