taler-typescript-core

commit c0001433bf8d7474b3c865f7ac603ccc3bb032ac
parent b89c231fa37e832ab298be89be878c5ce965e26d
Author: Hernâni Marques <hernani@vecirex.net>
Date:   Thu, 16 Jul 2026 10:53:28 +0200

fix/taler-merchant-webui (11472): document taler-assets submodule for compile; taler-merchant-webui tested to build

Diffstat:
M
packages/taler-merchant-webui/README.md
 | 
22
+++++++++++++++++++---
M
packages/web-util/README.md
 | 
13
+++++++++++++

2 files changed, 32 insertions(+), 3 deletions(-)
diff --git a/packages/taler-merchant-webui/README.md b/packages/taler-merchant-webui/README.md
@@ -10,11 +10,27 @@ The Merchant Admin Frontend is a Single Page Application (SPA) that connects wit
 
 ## Compiling from source
 
-Run `pnpm install --frozen-lockfile --filter @gnu-taler/merchant-backoffice...` to install all the nodejs dependencies.
+From the repository root, initialize the assets submodule (required by
+`@gnu-taler/web-util` for SVG logos such as the QR branding). Without it,
+`compile` fails with unresolved `@assets/svg/...` imports:
 
-Then, entering the command `pnpm build` creates the distribution in the `dist` folder.
+```shell
+git submodule update --init contrib/taler-assets
+```
+
+Install Node dependencies for this package and its workspace dependencies:
+
+```shell
+pnpm install --frozen-lockfile --filter @gnu-taler/taler-merchant-webui...
+```
+
+Compile the SPA (TypeScript + bundle into `dist/`):
+
+```shell
+pnpm run --filter @gnu-taler/taler-merchant-webui... compile
+```
 
-By default, the installation prefix will be `/usr/local/share/taler/merchant-backoffice/` but it can be overridden by `--prefix` by the configuration process:
+By default, the installation prefix will be `/usr/local/share/taler-merchant-webui/` but it can be overridden by `--prefix` by the configuration process:
 
 ```shell
 ./configure --prefix=/another/directory
diff --git a/packages/web-util/README.md b/packages/web-util/README.md
@@ -1,3 +1,16 @@
 # web-util
 
 Common utilities for other web applications in this repository.
+
+## Build requirements
+
+SVG assets are imported via the `@assets/*` path alias and live in the
+`contrib/taler-assets` git submodule at the monorepo root. Before compiling
+this package (or any consumer such as `taler-merchant-webui`), initialize it:
+
+```shell
+git submodule update --init contrib/taler-assets
+```
+
+Without that step, `./build.mjs` fails with errors like
+`Could not resolve "@assets/svg/logo/qr-logo.svg"`.