1.7 KiB
Merchant Admin Frontend
Merchant Admin Frontend is a Single Page Application (SPA) that connects with a running Merchant Backend and lets you manage instances, orders, products and tipping.
System requirements
- Node: v16.15.0
- pnpm: 7.14.2
- make
Compiling from source
Run pnpm install --frozen-lockfile --filter @gnu-taler/merchant-backoffice... to install all the nodejs dependencies.
Then the command pnpm build create the distribution in the dist folder.
By default the installation prefix will be /usr/local/share/taler/merchant-backoffice/ but it can be overridden by --prefix in the configuration process:
./configure --prefix=/another/directory
To install run make install
Running develop
To run a development server run:
./dev.mjs
This should start a watch process that will reload the server every time that a file is saved.
The application need to connect to a merchant-backend properly configured to run.
Building for deploy
To build and deploy the SPA in your local server run the install script:
make install
Runtime dependencies
-
preact: Fast 3kB alternative to React with the same modern API
-
preact-router: URL component router for Preact
-
SWR: React Hooks library for data fetching (stale-while-revalidate)
-
Yup: schema builder for value parsing and validation (to be deprecated)
-
Date-fns: library for manipulating javascript date
-
qrcode-generator: simplest qr implementation based on JIS X 0510:1999
-
@gnu-taler/taler-util: types and tooling
-
history: manage the history stack, navigate, and persist state between sessions
-
jed: gettext like library for internationalization