Skip to Content
Author's profile photo Jerry Wang

Step by step to run your Fiori application locally on NodeJS

1. download and install NodeJS in your local laptop:
Type node -v to ensure it works correctly:

2. install and configure Grunt. Grunt is a JavaScript task runner which can finish repetitive task for you. In this tutorial, I use it to launch local NodeJS server automatically. Installation could be done via command line: npm install -g grunt-cli
Once done, you can see the following output:
Check the folder listed in the console, you can see lots of stuffs regarding Grunt have been automatically downloaded.

3. Go to the root folder of your Fiori application, type npm init. There will be a tutorial which can guide you to generate package.json file.

Add the following part to your package.json file:

"devDependencies": {
  "grunt": "^0.4.5",
  "grunt-connect-proxy": "^0.2.0",
  "grunt-contrib-connect": "^0.9.0",
  "load-grunt-tasks": "^3.4.1"

I attach the complete package.json file of my Fiori project for your reference.

  "name": "simplefiori",
  "version": "1.0.0",
  "description": "Jerry's test Fiori project",
  "main": "index.html",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  "repository": {
    "type": "git",
    "url": "git+"
  "keywords": [
  "author": "i042416",
  "license": "ISC",
  "bugs": {
    "url": ""
  "homepage": "",

  "devDependencies": {
  "grunt": "^0.4.5",
  "grunt-connect-proxy": "^0.2.0",
  "grunt-contrib-connect": "^0.9.0",
  "load-grunt-tasks": "^3.4.1"
4. Type npm install in your Fiori project root folder. Once done, there will be a folder node_module generated which contains lots of necessary module:
5. Create a file named Gruntfile.js in the root directory of your project. This file works as a task descriptor which tells Grunt how to launch NodeJS server and the task detail it should perform.

Here below is my Gruntfile.js:

module.exports = function (grunt) {


        pkg : grunt.file.readJSON('package.json'),
        connect : { 
            serve : { // name of the target
                options : {
                    hostname : "localhost",
                    port : 8080,
                    base : "./",
                    open : "http://localhost:8080/webapp/Component.html", 
                    middleware : function (connect, options) {
                        // See document in

                        if (!Array.isArray(options.base)) {
                            options.base = [options.base];

                        var middlewares = [require('grunt-connect-proxy/lib/utils').proxyRequest];

                        options.base.forEach(function (base) {

                        var directory = || options.base[options.base.length - 1];

                        return middlewares;
            proxies : [
                    context : '/resources',
                    host : '',
                    port : 8080,
                    https : false,
                    rewrite : {
                        '^/resources' : '/sapui5-dist-1.40/resources'
        eslint : {
            target : ["webapp/**/*.js"]

    grunt.registerTask('serve', ['configureProxies:serve', 'connect:serve:keepalive']);


Here below is my Component.html:


<meta http-equiv="X-UA-Compatible" content="IE=edge">
<title>Jerry's test Fiori page</title>

<script src="/resources/sap-ui-core.js" id="sap-ui-bootstrap"
	data-sap-ui-libs="sap.m, sap.ushell, sap.ui.comp"

<script>"JerryTest", './');
	sap.ui.getCore().attachInit(function() {
		new sap.m.Shell({
			app : new sap.ui.core.ComponentContainer({
				name : "JerryTest"

<body class="sapUiBody" role="application">
	<div id="content"></div>

6. Now everything is done. Type command line grunt serve, and you should see the following output: local server is working and the html file you specified in Gruntfile.js is automatically opened:
The Fiori application runs correctly in Chrome now:
Please notice that this grunt serve is just a short cut, the complete path could be got from task manager: node “C:\Users\i042416\AppData\Roaming\npm\node_modules\grunt-cli\bin\grunt” serve

Assigned Tags

      You must be Logged on to comment or reply to a post.
      Author's profile photo Helmut Tammen
      Helmut Tammen

      Hi Jerry,
      did you see my blog that covers the same issue? Haven't read yours in detail but seems to be quite similar.

      Author's profile photo Jerry Wang
      Jerry Wang
      Blog Post Author

      Hello Helmut,

      I am still a newbie to NodeJS, I just wrote down what I have learned recently. I have gone through your blog, which is far more informative and impressive. I learned a lot by reading it. Thank you!

      Best regards,

      Author's profile photo Cesar Felce
      Cesar Felce

      Hi Jerry,

      Awesome blog, but i'm still having a hard time to locally run it.

      What about the proxy configuration for your OData destination services, and also the resources folder the url is no working anymore.


      I hope you can give me some ideas,


      Kind Regards,