HTML5 Application Repository
The HTML5 Application Repository is an SAP BTP service that stores the static content of HTML5 and SAPUI5 applications, such as HTML, JavaScript and CSS files, centrally in a subaccount. An application router, usually the one managed by SAP, serves that content to browsers, and SAP Build Work Zone picks the apps up as launchpad content.
Quick facts
- Type
- SAP BTP service for static UI content
- Layer
- SAP BTP side lane
- Service plans
- app-host (deploy) and app-runtime (consume)
- Consumed by
- Managed or standalone application router; SAP Build Work Zone
- Deployed with
- HTML5 application deployer in a multitarget application (MTA)
- Who works with it
- SAP Fiori and SAPUI5 developers, SAP BTP administrators
- Applies to
- SAP BTP, Cloud Foundry and Kyma runtimes
Layer: SAP BTPWhere it sits ▾
Layer: SAP BTP
Open the architecture map →How does the HTML5 Application Repository work?
The repository separates where UI files are stored from what serves them:
- A developer builds a SAPUI5 app, typically in SAP Business Application Studio, and packages it in a multitarget application.
- At deployment, the HTML5 application deployer uploads the app's static files to a service instance of the app-host plan.
- An application router bound to an app-runtime instance retrieves those files at runtime, authenticates the user and forwards data calls to backends through destinations.
- SAP recommends the application router managed by SAP, which needs no runtime of its own; a self-run router is meant for advanced cases such as router extensions.
Because the files are decoupled from the router, a new app version goes live without restarting anything, and the service keeps versions and caches content. The HTML5 Application Repository is storage and delivery for UI files, not a runtime for business logic.
How do apps in the HTML5 Application Repository reach SAP Build Work Zone?
When a subaccount subscribes to SAP Build Work Zone, an HTML5 Apps content provider appears automatically in the Channel Manager. It reflects the apps deployed to that subaccount's repository. To show an app on a site:
- Describe it in manifest.json: a unique app ID, a business service name (sap.cloud.service) and an inbound with semantic object and action.
- Deploy it to the same subaccount as the SAP Build Work Zone subscription.
- Update the HTML5 Apps content provider in the Channel Manager.
- Add the app in the Content Explorer, then assign it to groups, catalogs and roles, and the roles to a site.
A frequent mistake is skipping step 3 and wondering why a new version is missing. The HTML5 Application Repository delivers the files, while SAP Build Work Zone decides who sees the tile.
What are the strengths of the HTML5 Application Repository, and where does it stop?
Strengths
- Zero-downtime updates: content changes without restarting the application router.
- Serverless delivery: with the managed application router, a UI needs no running application instance.
- Sharing and versioning: public apps can be consumed by routers in other spaces, and content can be explored by version.
Where it stops
- Static content only. OData services, business logic and data live elsewhere, for example in CAP, RAP or SAP S/4HANA.
- Documented limits. SAP documents 100 MB per app-host instance and rate limits per subaccount for deployments and runtime requests.
- No personal data. Because content can be shared, SAP advises against storing personal data in it.
- Subaccount scope. Work Zone integration expects apps in the same subaccount as the subscription.
The HTML5 Application Repository answers where SAPUI5 files live on SAP BTP, not how the app behind them works.
Should you use the HTML5 Application Repository or Application Frontend service?
SAP now also offers Application Frontend service, which hosts and serves frontend applications as a single entry point, with its own CLI, cockpit UI and multiple active versions. SAP positions it for new standalone, single-tenant apps that do not connect to other applications, and notes that productive use requires an SAP Build license.
| Choose | When |
|---|---|
| HTML5 Application Repository with the managed application router | Apps shown in SAP Build Work Zone, apps that share content, multitenant or established MTA projects |
| Application Frontend service | New standalone, single-tenant apps where an SAP Build license is in place |
SAP states that teams whose needs are met by the HTML5 Application Repository and the application router can keep using them. Apps deployed with Application Frontend service can also be added to SAP Build Work Zone, standard and advanced edition, either manually as URL apps or through a Common Data Model configuration.
HTML5 Application Repository vs. SAP Build Work Zone vs. Application Frontend service: what is the difference?
| HTML5 Application Repository | SAP Build Work Zone | Application Frontend service | |
|---|---|---|---|
| What it is | Storage for static UI files | Launchpad and site service | Hosting and serving service for frontend apps |
| Question it answers | Where do the app's files live? | Who sees which tile on which site? | Where is a standalone UI hosted and served? |
| Serves content through | An application router | Its own site runtime, using apps from content providers | The service itself |
| Typical use | SAPUI5 apps for Work Zone sites | Central entry point for many apps | New standalone, single-tenant UIs |
The HTML5 Application Repository stores app files, SAP Build Work Zone presents apps to users, and Application Frontend service is a newer all-in-one host for standalone UIs.
FAQ
What is the difference between the app-host and app-runtime plans?
The app-host plan is used at deployment: its service instance receives the static files of the HTML5 apps. The app-runtime plan is used at runtime: an application router bound to it reads those files from the HTML5 Application Repository and serves them to the browser.
Why does my new app version not appear in SAP Build Work Zone?
The HTML5 Apps content provider in the Channel Manager must be updated after every deployment. Also check that the app was deployed to the same subaccount as the SAP Build Work Zone subscription and that its manifest declares a unique app ID, business service name and inbound.
Is there a size limit for the HTML5 Application Repository?
Yes. SAP documents a limit of 100 MB per service instance of the app-host plan, plus rate limits per subaccount for deployments and runtime requests. SAP also recommends other deployers than the standard HTML5 application deployer for content larger than 10 MB.
Do on-premise SAP Fiori apps use the HTML5 Application Repository?
No. SAP Fiori apps for SAP S/4HANA on-premise and Private Edition are deployed to the ABAP system and served by its launchpad. The HTML5 Application Repository is for apps deployed to SAP BTP, including extensions that call SAP S/4HANA through destinations.
Sources
- SAP Help Portal: HTML5 Application Repository
- SAP Help Portal: Developing HTML5 Applications in the Cloud Foundry Environment
- SAP Help Portal: HTML5 Apps Content Provider (SAP Build Work Zone, standard edition)
- SAP Help Portal: What Is Application Frontend Service?
- SAP Help Portal: Integrating Applications with SAP Build Work Zone (Application Frontend service)
- Applies to
- SAP BTP
- Last reviewed