fh-advanced-webapp-blank-app

Author: Erik Jan de Wit
Level: Intermediate
Technologies: Javascript, RHMAP
Summary: An advanced web application template to use with RHMAP.
Community Project: FeedHenry
Target Product: RHMAP
Product Versions: RHMAP 3.8.0+
Source: https://github.com/feedhenry/fh-advanced-webapp-blank-app Prerequisites: fh-js-sdk : 2.14.+

What is it?

This application is an advanced web application template. It should be used in combination with the HelloWorld cloud app. Refer to fhconfig.json for configuration.

If you do not have access to a RHMAP instance, you can sign up for a free instance at https://openshift.feedhenry.com/.

How do I run it?

RHMAP Studio

This application and its cloud services are available as a project template in RHMAP as part of the "Hello World Web App Project" template.

Local Clone (ideal for Open Source Development)

If you wish to contribute to this template, the following information may be helpful; otherwise, RHMAP and its build facilities are the preferred solution.

Prerequisites

• fh-js-sdk : 2.14.+

Build instructions

• npm install
• Edit fhconfig.json to include the relevant information from RHMAP.
• Build and run locally

npm start  

Go to http://localhost:8001/

npm dependencies

The fh-js-sdk and other development dependencies are defined in package.json and included in a browserified script.

• This generated main.js file is checked-in to allow RHMAP studio preview to statically serve dependencies.

• The init.js file is browserified and acts as a bridge between template script and npm dependencies.

• All the other JavaScript files in the template app will not be browserified, in order for you to be able to experiment live edit in RHMAP Studio preview.

Updating fh-js-sdk version

To update the JS SDK:

• change the version in package.json
• run npm install a grunt task is automatically ran to regenerate main.js
• check-in git repo the npackage.json + main.js

Grunt

This template uses Grunt, the Javascript Task Runner. To use Grunt with this Template App, do the following:

• Install grunt: npm install -g grunt-cli
• In your App directory, run: npm install. This installs Grunt plugins, etc for use with this App.
• Run npm start to preview this App locally

FeedHenry local development

You can also use Grunt to point your App at a local developement server. To do this, use the grunt serve:local command. Some notes on using the serve:local task:

• by default, the local server development url is: http://localhost:8001
• you can change this directly in your local Gruntfile.js, in the app config:

  app: {
    // configurable paths
    app: 'www',
    url: '',
    default_local_server_url: 'http://localhost:8001'
  },

• you can also pass a 'url' optional flag to server:local, e.g. grunt serve:local --url=http://localhost:9000

• you can also write your own tasks by extending the Gruntfile.js, e.g. add a 'serve:live' target that hits your server in your FeedHenry live enivronment.