Getting Started with the Jive Node SDK

Document created by yuval.z Employee on Mar 21, 2014Last modified by rachita on Jun 20, 2018
Version 37Show Document
  • View in full screen mode

The Jive Node SDK is a great way to quickly get started in order to create tiles, apps, cartridges, external storage frameworks, and other Jive add-ons. You can start out with some of the provided examples and then create your own solutions.

 

NOTE: The Jive Node SDK works with Jive version 7 and later. It can be used for both on-prem and cloud customers.

 

 

Before You Begin

 

Before starting a Jive Node SDK tutorial, be sure to install the SDK (Installing the Jive Node SDK). Once you've installed the SDK, type "jive-sdk" at the command line to view the command line help:

 

Jive Node SDK version 0.1.210
usage: jive-sdk   [--options]

Available commands:
   help                  Display this help page
   list                  List the existing items for a category
   create                Create a jive-sdk template or example
   build                 Build an addon package

Available category items for list command:
   tiles
   apps
   services
   storages
   cartridges
   examples

Available template items for create command:
  activity-stream       A basic activity stream
  app                   A basic Jive app
  app-ext-object        A basic example that uses simple stream integrations and Jive app external objects
  cartridge             A basic cartridge
  esf                   An external storage framework that uses a file system
  oauth2-client         A quick project for creating OAuth2 client add-ons
  service               A basic service
  tile-app-action       A custom view tile with a tile action (Jive-hosted)
  tile-app-external     An external custom view tile
  tile-app-internal     A custom view tile with configuration (Jive-hosted)
  tile-app-simple       A basic custom view tile (Jive-hosted)
  tile-carousel         A basic carousel tile
  tile-gallery          A basic gallery tile
  tile-gauge            A basic gauge tile
  tile-list             A basic list tile
  tile-sectionlist      A basic sectionlist (aka accordion) tile
  tile-table            A basic table tile
  (Use "jive-sdk list examples" to view other items that you can create)

Available items for build command:
   add-on

Available options:
   --force=           Whether to overwrite existing data; defaults to false
   --name=""              Use the specified string for the new item name
   --apphosting="<self|jive>"     "jive" apps are packaged in the add-on, "self" apps are hosted externally; defaults to "self"
   --oauthAuthorizeUrl="...."     Used only with "jive-sdk create oauth2-client" for;
                                  simple OAuth2 client generation
            

 

We have created several tutorials in the Jive Community to help you get started.

 

First Tutorial

 

If you have never created a Jive Node SDK project, we suggest you start with the List Tile tutorial (Creating a List Tile with the Jive Node SDK). This project shows you how to quickly create a list tile within a Jive Purposeful Place.

tile-1.png

The tutorial walks you through the process of installing the tile, and then gives you guidance on how to extend the tile once you're ready to move on.

 

Getting Started Tutorials

 

Once you've played with the list tile tutorial, check out our other Getting Started tutorials.

 

Tutorial TypeLinkRequires Building a Service?
TILE TUTORIALS
List Tile TutorialGetting Started > Creating a List Tile with the Jive Node SDKYes
Carousel Tile TutorialGetting Started &gt; Creating a Carousel Tile with the Jive Node SDK (Cloud & 8.0 only)Yes
Custom View TilesCreating Custom View Tiles (Cloud & 8.0 only)Both options available
Tile Action TutorialGetting Started > Using Tile Actions with the Jive Node SDKYes
Posting Data from Tile to ServiceHow to POST to a Service from a TileYes
STREAM TUTORIALS
Simple Stream with Appjive-sdk create simple-stream --name="yourAppName"No
Activity StreamGetting Started > Creating an External Activity StreamYes
App inside a StreamHow to embed an app within an external stream objectYes
APP TUTORIALS
App TutorialGetting Started > Creating an App with the Jive Node SDKYes
Jive-hosted App TutorialCreating Jive-hosted Apps (Cloud & 8.0 only)No
OTHER TUTORIALS
OAuth2 ClientOAuth 2.0—Creating a Client and Managing Access No
Webhooks TutorialGetting Started > Using Webhooks with the Jive Node SDK
Data Export Service (DeS)

Jive Developer Series - Exploring the Data Export API

  • jive-sdk create example-analytics --name="my-des-client"
No
Cartridge TutorialGetting Started > Creating a Cartridge with the Jive Node SDKNo
External Storage Framework (ESF)Getting Started with the External Storage Framework

 

Deploying Your Project

 

Once you've created a Jive Node SDK project, you are ready to deploy your project to a Jive community as an add-on.

 

Other Resources

 

Attachments

    Outcomes