Usage of Cloudant in LoopBack Applications

The Node.js framework LoopBack supports multiple connectors for various data sources. Below is a sample how to use the Cloudant NoSQL database in Bluemix.

Check out the sample code on GitHub. It shouldn’t take longer than 15 minutes to set up the sample application. The sample uses basically a CLEAN stack with Cloudant, LoopBack, Express, Angular and Node.

After you’ve created the Cloudant service on Bluemix you get your own credentials. The credentials are stored in environment variables and can be accessed by Bluemix applications. When running the same LoopBack applications locally, the credentials need to be copied to a local property file (env.json). The code in bluemix.js reads the credentials and sets up a LoopBack data source programmatically (it is not defined in datasources.json). The code uses the loopback-connector-cloudant which is installed via npm.

In order to make the setup of the sample application as easy as possible, a database is created automatically if it doesn’t exist and test data is stored in it for demonstration purposes.

In model-config.json you can refer to the Cloudant database in the same way as to other LoopBack data sources.

"ApprovalRequest": {
  "dataSource": "cloudant",
  "public": true
"Person": {
  "dataSource": "cloudant",
  "public": true

While loopback-connector-couch uses map/reduce views, loopback-connector-cloudant uses Cloudant Query. My colleague and developer of the Cloudant connector Tony Ffrench told me that the main benefit of Cloudant Query is that the filtering/ordering/paging is done on the server, vs sending the data across the network.

In the Cloudant dashboard you can invoke queries, for example to change test data directly in the database.

  "selector": {
    "username": "Admin"
  "use_index": "_design/lb-index-ddoc-Person"


2 thoughts on “Usage of Cloudant in LoopBack Applications

  1. Jo Torsmyr says:

    Your comment on difference in the loopback-connector-couch and loopback-connector-cloudant is very interesting.
    I started with loopback-connector-couch last year (the other one did not exist then). Now I use both (!), in the same application…because only loopback-connector-cloudant supports the bulk API, whilst for map/reduce I have to use loopback-connector-couch.
    It would have been handy if loopback-connector-cloudant would come with map/reduce support as well at some point, since this seems to be quite core in CouchDB…


    1. Tony Ffrench says:

      Jo, please open an enhancement issue over here map/reduce is core to Couch & Cloudant, but we built the Cloudant connector with a view to minimizing the overlap with the existing couch community connector. Lets continue this conversation on github. Thanks, Tony

Leave a Reply