This article walks you through deploying your first integration. This integration will be a custom widget that displays an <h1> element on the page with an innerHTML value of "Hello World." It will also take a string value (text) from the configuration screen and display it as a description below the <h1> element.

1. Create a project directory

Create a project directory in your development environment.

After creating a local directory for your new project, run the following command inside it using Command Line (Windows) or Terminal (mac):

#!/bin/sh
# This will install ig-deploy into your project directory
npm install --save @igloosoftware/ig-deploy

2. Download the example project

Download the official Igloo Hello World integration code found at the end of this article and extract it into your project directory. 

3. Manage credentials

Open credentials.json from the root of your project directory and configure the contents as follows:

{
  "account": "<yourIglooRepoName>",
  "key": "<yourAzureKey>",
  "url": "https://<yourIglooRepoName>.blob.core.windows.net/",
  "environment": "<friendlyName>",
  "provider": "azure"
}

4. Deploy

Run the following command to deploy the widget to your Igloo-provided Azure instance:

#!/bin/sh
# This command runs deploy.js- which deploys the widget to Azure
node deploy.js

5. Test the integration in your digital workplace

Inside your Igloo digital workplace, place an Integrations widget on a page and select Edit to configure it. Select your repository from the Integration Library dropdown, and you should see ig-deploy-hello-world with a green Igloo icon as shown in the figure below (Fig 5.1)