OMS Web Application

This repository contains a web application that enables one to interact with the Order Management System (OMS) reference application. Code for the OMS is maintained in the reference-app-orders-go repository. Since this web application depends on services provided by the OMS, you will need code from both repositories to run it.

The steps below minimally cover how to run and build the web application. See the other repository for detailed instructions on running and using the Order Management System.

Running the Web Application Locally

After you start the API servers and one or more Workers, as described in the OMS instructions, run the following pnpm commands from the root directory of this project:

pnpm i
pnpm dev

This starts a local server. You can navigate to http://127.0.0.1:5173/ to view the web application.

NOTE: As a workaround for deployment to GitPod, in which the domain of each application container is assigned dynamically, this application disables the CSRF origin check. Pull request #6 describes this in more detail, and we recommend reinstating this origin check for improved security in a real-world deployment.

Building the Web Application

Run pnpm build to create a production version of your app. You can then preview the production build by running pnpm preview.

The .github/workflows/docker-publish.yml file automates the creation and publication of Docker images in response to code changes.