Core Application: Web Wrapper

The Atlas Web Application Wrapper is an Electron based chromeless, kiosk ready wrapper for HTML/Javascript based web application built on your favorite framework such as React, Vue or straight Vanilla JS either as a website (URL), or as a bundled Universal Application.

The Web Application Wrapper is intended to simplify the development and delivery of web applications, particularly those that need to be built against multiple architectures by providing ready made, production ready wrappers/harnesses.

This document steps thorugh how to configure the Web Application Wrapper within a Node Template to launch your web application.

TIP

The Web Application Wrapper is used to launch Universal Applications. To launch a Universal Application, add the application to your Node Template, the Web Application Wrapper will automatically be added to the template.

Use with Universal Applications

When a Node Template includes a Universal Application, the Experience Agent will automatically unpack the application zip file and link a local API endpoint to host the application as a website. This circumvents a lot of issues with attempting to access web resources when running an HTML file from the local file system.

The Experience Agent will then launch the Web Application Wrapper, automatically setting the ATLAS_WEB_APP_URL environment variable to the local application URL. This all happens automatically within the Experience Agent and no user intervention is required.

INFO

When debugging a Universal Application, add the --console and --dev arguments to the Universal Application arguments in your Node Template, NOT the web application wrapper.

Arguments

Argument	Description
--console	Automatically open the Chrome Tools console for debugging (requires --dev argument).
--dev	Enable development mode which removes restrictions like exiting the application via the keyboard.
--url	The application URL to load. (May also be set via environment variable)

Environment Variables

Variable	Description
ATLAS_WEB_APP_URL	The application URL to load.