Skip to Content

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
You must be Logged on to comment or reply to a post.
    • 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,

  • 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,