Using Nitrous.IO with the Jive Node SDK

Version 15

    Nitrous.io is no longer available. Please use a similar service Cloud9 - Your development environment, in the cloud OR our recommended local development tool Ngrok.io. To use Ngrok, we have written the following guides:

     

     

    Overview

     

    We get lots of feedback from developers working on systems behind a firewall who want to quickly test out the apps or tiles they created with the Jive Node SDK. The Jive Developer Sandbox is a great way to test your creations, but it requires that your service has a publicly routable address. To solve this problem, you can turn to one of the cloud-based IDEs.

     

    Nitrous.IO is a powerful, cloud-based IDE that can be a great solution for Jive developers.

     

    Here are some simple steps to get you started in just a few minutes using Nitrous.IO and the Jive Node SDK.

     

    Setup Instructions

     

    1. Create a free account with Nitrous.IO. A free account gives you a limited number of resources and features, but it is enough to test out how Nitrous works with the Jive Node SDK. If you enjoy using Nitrous.IO, consider upgrading.
      nitrous00.png
    2. Create a "New Box" using the "Node.js" template.
      nitrous01.png
    3. Install the Jive Node SDK:  npm install jive-sdk -g
      nitrous03.png

    You can now use the Jive Node SDK with Nitrous.IO.

     

    Jive Node SDK Walkthrough using Nitrous.IO

     

    If you'd like to be walked through a beginner tutorial using Nitrous.IO, refer to these instructions:

     

    1. To create a list tile with the Node SDK use the following command: jive-sdk create tile-list --name="nitrous-test"
      nitrous04.png
      See Getting Started with the Jive Node SDK | Jive Community for more information about other Jive Node SDK examples.
    2. Update dependencies: npm update
      nitrous05.png
    3. Grab the URL for your system. You can find the URL either from the Nitrous.IO dashboard (accessible from the Nitrous.IO home page), or you can use the "Preview" menu option when viewing the IDE, which will open a new tab using the URL.
      nitrous13.png
    4. Update the clientUrl property in jiveclientconfiguration.json with the URL for your system. (NOTE: You'll have to click the Refresh icon above the file browser before you can see any newly created files.)
      nitrous06.png
      Set "development": true (not pictured above) in the JSON.
      Save the file when you're done editing.
    5. Start your service: node app.js
      nitrous07.png
    6. Download extension.zip by right clicking this file in the file browser. (NOTE: You'll again have to click the Refresh icon above the file browser to see this new file.)
      nitrous08.png
    7. Browse to the Jive Developer Sandbox (or whichever Jive instance you are using) and install the extension.zip add-on that you just downloaded. (If you need help doing this, follow steps 3 through 7 of Getting Started > Deploying a Jive Node SDK Project as an Add-On.)
      nitrous09.png
      If you live outside the United States and you experience problems during add-on registration, try changing the "Region" of your Nitrous box to a US region.
    8. Put your new tile in a Purposeful Place and configure it. (If you need help doing this, follow step 5 from Getting Started > Creating a List Tile with the Jive Node SDK.)
      nitrous10.png
      nitrous11.png
    9. Watch it go!
      nitrous12.png

    Hopefully these instructions illustrate the possibilities when using a cloud-based IDE with the Jive Node SDK.

     

    Now you can make a more elaborate tile by following Getting Started > Creating a List Tile with the Jive Node SDK, or you can try the other Getting Started Tutorials with your Nitrous.IO box...