.. | ||
contrib | ||
src | ||
.gitignore | ||
build.mjs | ||
copyleft-header.js | ||
DESIGN.md | ||
dev.mjs | ||
Makefile | ||
package.json | ||
preact.config.js | ||
preact.single-config.js | ||
README.md | ||
remove-link-stylesheet.sh | ||
tsconfig.json |
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