wallet-core/packages/merchant-backoffice-ui
2023-08-07 08:14:45 -03:00
..
contrib repo: integrate packages from former merchant-backoffice.git 2022-10-24 10:46:14 +02:00
src use stringify taler util 2023-08-07 08:14:45 -03:00
.gitignore repo: integrate packages from former merchant-backoffice.git 2022-10-24 10:46:14 +02:00
build.mjs new asset api 2023-06-01 14:26:07 -03:00
copyleft-header.js update copy header 2022-12-16 16:59:37 -03:00
DESIGN.md bring documentation from old repo and fix Makefile to copy all content of dist folder 2023-01-21 20:20:42 -03:00
dev.mjs new asset api 2023-06-01 14:26:07 -03:00
Makefile repo: fix Makefiles / top-level 'make install' target 2023-06-21 09:44:02 +02:00
package.json bump typescript version 2023-06-06 11:54:37 +02:00
preact.config.js update copy header 2022-12-16 16:59:37 -03:00
preact.single-config.js update copy header 2022-12-16 16:59:37 -03:00
README.md bring documentation from old repo and fix Makefile to copy all content of dist folder 2023-01-21 20:20:42 -03:00
remove-link-stylesheet.sh repo: integrate packages from former merchant-backoffice.git 2022-10-24 10:46:14 +02:00
test.mjs new asset api 2023-06-01 14:26:07 -03:00
tsconfig.json module resolution = node16 2023-02-16 12:13:31 -03:00

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