aboutsummaryrefslogtreecommitdiff
path: root/packages/merchant-backoffice-ui/README.md
blob: 34bb98b67b8e4d459e9b24b41ca8533b87c1fd7c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
## 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:

```shell
./configure --prefix=/another/directory
```

To install run `make install`

## Running develop

To run a development server run:

```shell
./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:

```shell
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