Skip to content
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

TodoList CouchDB and Cloudant backend

Todo backend is an example of using the Kitura Swift framework for building a productivity app with a database for storage of tasks.

Build Status

Quick start for local development:

You can set up your development environment and use Xcode 9 for editing, building, debugging, and testing your server application. To use Xcode, you must use the command line tools for generating an Xcode project.

  1. Download Xcode 9

  2. Download CouchDB and install

    brew install couchdb
  3. Clone the TodoList CouchDB repository

    git clone
  4. Generate an Xcode project

    swift package generate-xcodeproj
  5. Start CouchDB

  6. Run the Server target in Xcode and access http://localhost:8080/ in your browser to see an empty database.

Quick start on Linux

To build the project in Linux, you need to first install the Swift 4 toolchain.

  1. Install the Swift 4 RELEASE toolchain

  2. Install CouchDB:

    sudo apt-get install couchdb
  3. Clone the repository:

    git clone
  4. Compile the project

    swift build
  5. Run the server:


Then access http://localhost:8080/ in your browser to see an empty database.

Deploying to IBM Cloud

Using the IBM Cloud Tools for Swift

The TodoList for Cloudant is deployable with a graphical user interface. Download:

Deploy to IBM Cloud Button

You can use this button to deploy TodoList to your IBM Cloud account, all from the browser. The button will create the application, create and bind any services specified in the manifest.yml file and deploy.

Deploy to IBM Cloud

Deploying Docker to IBM Cloud Container

For the following instructions, we will be using our Bash Script located in the root directory. You can attempt to complete the whole process with the following command:

./ all <imageName>

Or, you can follow the step-by-step instructions below.

  1. Install the Cloud Foundry CLI tool and the IBM Containers plugin for CF with the following

    ./ install-tools
  2. Ensure you are logged in with

    ./ login
  3. Build and run a Docker container with the following

    ./ build <imageName>

    To test out created Docker image, use

    ./ run <imageName>
    ./ stop <imageName>
  4. Push created Docker container to IBM Cloud

    ./ push-docker <imageName>
  5. Create a bridge CF application to later bind to your container

    ./ create-bridge
  6. Create the Cloudant service and bind to your bridge CF application.

    ./ create-db
  7. Create a IBM Cloud container group where your app will live, binding it to your bridge CF application in the process

    ./ deploy <imageName>

    Afterwards, you can ensure Cloudant was bound correctly by viewing all credentials for your group

    cf ic group inspect <imageName>
  8. Optionally, if you want to populate your database with some sample data, run the following command with your image name:

    ./ populate-db <imageName>

At this point, your app should be deployed! Accessing your apps route should return your todos, which should be [] if you did not populate the database.


IBM Cloud is a hosting platform from IBM that makes it easy to deploy your app to the cloud. IBM Cloud also provides various popular databases. Cloudant is an offering that is compatible with the CouchDB database, but provides additional features. You can use Cloudant with your deployed TodoList-CouchDB application.

  1. Get an account for IBM Cloud

  2. Download and install the Cloud Foundry tools:

    cf api
    cf login

    Be sure to run this in the directory where the manifest.yml file is located.

  3. Create your Cloudant Service

    cf create-service cloudantNoSQLDB Lite TodoListCloudantDatabase
  4. Push your app

    cf push

    *Note This step will take 3-5 minutes

    1 of 1 instances running
    App started
  5. Get the credential information:

    cf env TodoListCloudantApp

    Note you will see something similar to the following, note the hostname, username, and password:

       "cloudantNoSQLDB": [
            "credentials": {
               "host": "",
               "password": "<password is here>",
               "port": 443,
               "url": "",
               "username": "<username is here>"

At this point, your app should be deployed! Accessing your apps route should return your todos, which should be [] to start.


Copyright 2017 IBM

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software :distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.


Todolist implemented for Cloudant (CouchDB) backend



No packages published
You can’t perform that action at this time.