Ionic-Cloudant-FeedbackApp

An Ionic feedback app using Cloudant NoSQL service on IBM Bluemix. An easy to configure mobile app for receiving feedback at Meetups, Events etc.,

Ionic is a complete open-source SDK for hybrid mobile app development. Built on top of AngularJS and Apache Cordova, Ionic provides tools and services for developing hybrid mobile apps using Web technologies like CSS, HTML5, and Sass.

Cloudant is the distributed database as a service (DBaaS) built from the ground up to deliver fast-growing application data to the edge.

The App Runs on iOS and Android and build using Ionic Version 1.7.13

iOS:

Android:

Creating a Cloudant NoSQL DB service on IBM Bluemix

• Don’t have Bluemix account? Sign up to create a free trial account.
• Have a Bluemix account? Use this link.

Add a new Cloudant data service in just a few clicks:

1. Visit your Bluemix dashboard.
2. Click Catalog.
3. On the left Pane, Click on Data & Analytics under Services.
4. Click Cloudant NoSQL DB tile.
5. Enter a unique descriptive name in the Service name field.
6. Check Features, Images and Pricing Plans.
7. Click the Create button.

Cloudant Dashboard 2.0

Once the Cloudant service is created,

• Click on LAUNCH button to launch the Cloudant Dashboard 2.0 (Powerful querying, analytics, replication, and syncing happens here) on a seperate tab
• Create a new database by clicking on Create Database on the top ribbon. Your database is created.
• From the left Pane, Click on Account -> CORS Tab -> Check All domains ( * ). *Not recommended for all usecases, this being a simple mobile app taking this liberty. CORS Documentation

Configuring Ionic app with a configuration file

• Install Ionic

npm install -g cordova ionic@1.7.13

• Clone the repo

$ git clone https://github.com/IBM-Bluemix/feedbackapp-ionic-cloudant.git

• Open the unzipped folder in an IDE (I use Brackets) of your Choice and Navigate to www/js folder.
• Create a new Javascript file app.config With extension the file will be app.config.js
• Paste the below code in app.config.js,

angular.module('app').constant('CLOUDANTDB_CONFIG', {
    baseUrl: 'https://<hostname>',
    dbName: '<DBName>',
    userName: '<username>',
    password: '<password>'
});

• DBName - Name of the Cloudant NoSQL DB your created on Dashboard 2.0.
• For hostname,username and password - Navigate to the Cloudant Service page on Bluemix and Click on Service Credentials tab.
• Click on View Credentials under Actions.

placeholder	Cloudant Service
username	username
password	password
hostname	host

The CLOUDANTDB_CONFIG constant values are utilised in controllers.js

// Define the Credentials string to be encoded.
    var credentialstobeEncoded = CLOUDANTDB_CONFIG.userName + ":" + CLOUDANTDB_CONFIG.password;

    // Encode the String
    var encodedString = Base64.encode(credentialstobeEncoded);
    console.log("ENCODED: " + encodedString);

    $scope.createFeedback = function (feedback) {

        $http({
            method: 'POST',
            url: CLOUDANTDB_CONFIG.baseUrl + "/" + CLOUDANTDB_CONFIG.dbName,
            headers: {
                'Content-Type': 'application/json',
                'Authorization': 'Basic ' + encodedString
            },

Customize the App UI

• Images can be replaced with the same name under img folder.
• Customize the feedback fields in feedback.html
• There are validations on the fields based on the type. E.g., Email checks for @ in the entry. Submit will be disabled until the form is completely valid.

Testing the App

Desktop browser Testing

$ ionic serve

On an iOS Simulator or Android Emulator

$ ionic emulate ios
$ ionic emulate android

Note: Follow the Android and iOS platform guides to install required tools for development.

If you see this Error

Error: Cannot find module 'internal/fs'
at Function.Module._resolveFilename (module.js:470:15)
at Function.Module._load (module.js:418:25)
at Module.require (module.js:498:17)
at require (internal/module.js:20:19)
at evalmachine.<anonymous>:18:20
at Object.<anonymous> (/usr/local/lib/node_modules/ionic/node_modules/ionic-app-lib/node_modules/vinyl-fs/node_modules/graceful-fs/fs.js:11:1)
at Module._compile (module.js:571:32)
at Object.Module._extensions..js (module.js:580:10)
at Module.load (module.js:488:32)
at tryModuleLoad (module.js:447:12)
Cannot find module 'internal/fs' (CLI v1.7.13)

Resolution:

• Check Node version on your system

node -v

• If you see  v7.5.0, run the below commands one after another to add v6

export NVM_DIR=~/.nvm
source $(brew --prefix nvm)/nvm.sh
nvm install 6

If you see this error

Error: Cannot read property ‘replace’ of undefined

Solution:

cd platforms/ios/cordova/node_modules/
sudo npm install ios-sim@latest

Notes:

• This sample uses only the POST HTTP API call of Cloudant Service. To understand other HTTP API Verbs, Refer Cloudant Documentation
• Cloudant Client Libraries

License

See License.txt for license information.