snapshot of https://github.com/cortezaproject/corteza.git (2024.9.x, 2026-09-18; blobs > 131072B omitted)

server/webapp/.gitignore

@@ -0,0 +1,2 @@
+public
+*.tar.gz

server/webapp/Makefile

@@ -0,0 +1,55 @@
+.PHONY: all install-fresh install-packages build clean cleaner
+
+WGET         ?= wget
+WGET_FLAGS   ?= -q
+TAR          ?= tar
+TAR_FLAGS    ?= -xzmok
+RELEASE_PAGE ?= https://releases.cortezaproject.org/files
+APPS         ?= admin compose workflow reporter discovery privacy
+ALL_APPS     ?= $(APPS) one
+VERSION      ?= $(shell git describe --tags --abbrev=0)
+PACKAGES      = $(addprefix corteza-webapp-,$(addsuffix -$(VERSION).tar.gz,$(ALL_APPS)))
+SOURCE_LOC   ?= "../../webapp-"
+SOURCES       = $(addprefix $(SOURCE_LOC),$(ALL_APPS))
+
+all: install-packages
+
+install-packages: $(PACKAGES)
+	$(info installing packages to public/)
+	@ rm -rf $(addprefix public/,$(APPS))
+	@ mkdir -p $(addprefix public/,$(APPS))
+	@ $(TAR) $(TAR_FLAGS) -f corteza-webapp-one-$(VERSION).tar.gz -C public
+	@ $(TAR) $(TAR_FLAGS) -f corteza-webapp-admin-$(VERSION).tar.gz -C public/admin
+	@ $(TAR) $(TAR_FLAGS) -f corteza-webapp-compose-$(VERSION).tar.gz -C public/compose
+	@ $(TAR) $(TAR_FLAGS) -f corteza-webapp-workflow-$(VERSION).tar.gz -C public/workflow
+	@ $(TAR) $(TAR_FLAGS) -f corteza-webapp-reporter-$(VERSION).tar.gz -C public/reporter
+	@ $(TAR) $(TAR_FLAGS) -f corteza-webapp-discovery-$(VERSION).tar.gz -C public/discovery
+	@ $(TAR) $(TAR_FLAGS) -f corteza-webapp-privacy-$(VERSION).tar.gz -C public/privacy
+
+download: $(PACKAGES)
+
+$(PACKAGES):
+	$(info downloading $(RELEASE_PAGE)/$(@))
+	@ $(WGET) $(WGET_FLAGS) $(RELEASE_PAGE)/$(@)
+
+install-fresh: build
+	@ rm -rf public
+	@ cp -r $(SOURCE_LOC)one/dist       public/
+	@ cp -r $(SOURCE_LOC)admin/dist     public/admin
+	@ cp -r $(SOURCE_LOC)compose/dist   public/compose
+	@ cp -r $(SOURCE_LOC)workflow/dist  public/workflow
+	@ cp -r $(SOURCE_LOC)reporter/dist  public/reporter
+	@ cp -r $(SOURCE_LOC)discovery/dist public/discovery
+	@ cp -r $(SOURCE_LOC)privacy/dist 	public/privacy
+
+build: $(SOURCES)
+
+$(SOURCES):
+	$(info building $(@))
+	@ cd $(@) && yarn build
+
+clean:
+	@ rm -f $(PACKAGES)
+
+cleaner:
+	@ rm -rf public corteza-webapp-*.tar.gz

server/webapp/README.adoc

@@ -0,0 +1,54 @@
+= Web applications
+
+Rationale behind `/webapp/...` tools is to allow backend developers to quickly test server with frontend applications.
+Tools (see Makefile) download and install unstable (can be changed with `VERSION` var).
+
+.Downloads and installs packages under webapp/public using current version
+[source,shell]
+----
+make
+----
+
+.Downloads and installs packages under webapp/public using specific version
+[source,shell]
+----
+make VERSION=2021.3.3
+----
+
+. All available make targets
+[cols="2m,5a"]
+|===
+|target|
+
+| all
+| default target alias for install-packages
+
+| install-package
+| installs all packages
+
+| download
+| downloads all packages
+
+| install-fresh
+| builds and installs all packages from source
+
+| install-fresh
+| builds and installs all web applications from source
+
+| build
+| builds all web applications from source
+
+| clean
+| removes packages of the current versions
+
+| cleaner
+| removes all
+
+|===
+
+
+To enable serving of webapps from the server, make sure `HTTP_WEBAPP_ENABLED` is set to `true`.
+This will prefix all API endpoints with `/api/`.
+
+See `HTTP_API_BASE_URL`, `HTTP_WEBAPP_ENABLED`, `HTTP_WEBAPP_BASE_URL`, `HTTP_WEBAPP_BASE_DIR`, `HTTP_WEBAPP_LIST` for
+details