Getting Started

Prerequisites

• Github account

• Avnet Things account

Further Reading

• Github Pages

Getting Started with Github

Log on to Github. If you do not have an account, please create one. Github provides us a convenient feature called Github pages where it hosts our web based projects for us. To get started, let's fork one of our sample projects we have. Click here, and follow the image below to fork the project. Once forked, click on settings.

Now that you are viewing the settings of your project, we'd like to scroll until you see GitHub Pages. In that section, we want to select what branch of code GitHub pages will publish from. To keep things simple, let's select master branch. If you refresh the page and head to the same section, you'll see a url show up. That is the location of your site. The url follows <username>.github.io/<repo_name>.

Publishing on Avnet Things

First we have to create an account on Avnet Things and give an organization name. Once account is created, you'll see there are apps available to you by default. We can also create and publish our own apps. We already published our app on the web using GitHub, now we can use the application on Avnet things. Publishing an app is very simple. To get there, we have to click on organizations. Once you see your organization, we enter in our organization's settings by clicking on it's name. Once we are in full view of all the settings, there are three tabs - "Users" - "Applications" - "My Applications". Click on "My Applications" and then the plus sign on the top right. Give your app a name, set the application url field with the GitHub pages url of your application. Set the filters the application will need. For our example, we will use filter by name and the name of the device we are looking for is HEXIWEAR. An explanation of the application can be found here.