Step 1: Build Your App

• A. Create a new repo on your local machine

  (for help with this, check out GitHub's excellent doc )

• B. Add an index.html file

  For now, just put something simple and fun in there to make sure everything is working:

  <html>
  <head>
    <style>
    img {
      /* upside down! */
      -webkit-transform: rotate(180deg);
      -moz-transform: rotate(180deg);
      max-width:300px;
      max-height:300px;
    }
    </style>
    <script src="https://ajax.googleapis.com/ajax/libs/jquery/1.7.1/jquery.min.js" type="text/javascript"></script>
    <script src="https://api.hubinga.com/js/api.js" type="text/javascript"></script>
    <script type="text/javascript">
      $(function() {
        var client = new APIClient('http://localhost:8042');
        // get some photos
        client.getJSON('/Me/photos', {limit: 10}, function(photos) {
          console.log('found ' + photos.length + ' photos');
          // add them to the DOM
          for(var i in photos) {
            console.log('photo #' + i, photos[i]);
            $('body').append('<img src="' + photos[i].url + '">');
          }
        });
      });
    </script>
  </head>
  <body>
  </body>
  </html>

• Open index.html in a browser — will ask for your Hubinga API key, enter it — it works!

  It probably looks really ugly, but that's where you come in — take it from here!

Step 2: Prepare to publish

Once you are ready to publish your App (or at least see it in your Hubinga account), you will need to add a package file and push your work to GitHub — it will sync from GitHub to your Hubinga account automatically.

• A. Add a package.json file

  The package.json file in the root directory of your App specifies some basic info about your app. Minimally, you need at least these fields populated:

  {
    "description": "See all my photos, but upside down!",
    "repository": {
      "title": "Upside Down Photos",
      "uses": {
        "types": [ "photos" ],
        "services": [ "facebook", "twitter", "foursquare", "instagram" ]
      }
    }
  }
  

  Without those fields populated, your App will not be synced to your Hubinga account. For more info about the package.json file, see the package.json documentation .

• B. Add a screenshot

  Take a screenshot and put it in the root directory of your App as screenshot.png

• C. Push to GitHub:

  Commit your changes and push to GitHub.

  git add  .
  git commit -m 'ready to go'
  git push origin master

  Your app will be synced to your Hubinga account automatically.

Step 3: Publish your App to the Company Store!

Once your App is synced to your Hubinga account, it will show up in the "Your Apps" section under DEVELOP. Click on the App, make sure everything is working, and then click the PUBLISH button in the header.

For more info, see the full publishing documentation .