Home Page UI5 middleware

This package is a part of Fiori Tools Extensions project which is set of plugins working on top of SAP Fiori Tools or UI5 server

What does it do?

Standard fiori run / ui5 serve command run http://localhost:8080 serving your static file tree by default. This extension may redirect you to a specifc page from a root path.

In the template provided by Fiori Tools application generator we can see test/flpSandbox.html and test/flpSandboxMockServer.html files. Besides of that we have also sandbox launchpad available as a part of UI5 library and we can take it directly from the test resources. Fiori Launchpad - Sandbox for application development. In addition to that, sandbox launchpad delivers possibility to maintain application config as a separate fioriSandbox.json file which creates even a space to generate it via API.

How to use

Standard fiori run/ui5 serve command run just http://localhost:8080 page while may be you want to redirect to a specifc page as a home page. This extension can be used in two modes:

server:
  customMiddleware:
    - name: fiori-tools-home-page
      beforeMiddleware: serveIndex
      configuration:
        home_page: path/to/your/home/page.html
        query:
          use-additional-parameter: true

or just like this as a shortcut to home_page: /test-resources/sap/ushell/shells/sandbox/fioriSandbox.html, delivered by ui5 library itself.

server:
  customMiddleware:
    - name: fiori-tools-sandbox
      beforeMiddleware: serveIndex
      configuration:
        query:
          sap_ui_debug: true

it is important to remember that /test-reources should be served by your server too, for example using proxy middleware

server:
  customMiddleware:
    - name: fiori-tools-proxy
      beforeMiddleware: compression
      configuration:
        ui5:
          path:
            - /resources
            - /test-resources
        url: https://ui5.sap.com