Frontend ¶
The SciCat frontend is the SciCat metadata catalogue web UI, built on top of the Angular framework.
Configuration options ¶
The frontend configuration is set by the
config files
. Files inside the
config
folder, with a
.json
extension are merged respecting the alphabetical order of the files in the
container
, with
config.v3.json
applied depending on the
BE_VERSION
.
When using the frontend image >=
5.5.0
, the values
from
config.json in the upstream
are used as defaults.
For an extensive list of available options see the official SciCat documentation in the SciCat frontend section.
Default configuration ¶
In the default configuration
config
, the frontend is set to call the
backend service
available at
backend.localhost
(either
v4
, by default, or
v3
if specified
otherwise by setting
BE_VERSION
).
For an explanation of how setting
BE_VERSION
changes the environment creation see the
configuration options in the root docs
.
Enable additional features ¶
Since there was a small breaking change from
v3
to
v4
, when connecting to the
backend
, the
BE_VERSION
value
controls if
config.v3.json file
, which is applied when
BE_VERSION=v3
, should be included in
the configs merge process.
Setting the
BACKEND_HTTPS_URL env variable
requires changing the
backend
URL used by the
frontend
.
When setting
FRONTENT_HTTPS_URL
it is likely you also want to set the
BACKEND_HTTPS_URL
, to allow the
communication between the two wherever the browser is accessed.
DEV configuration ¶
With
FRONTEND_DEV=true
(or
DEV=true
), please use
npm start -- --host 0.0.0.0
. This is to allow traffic from any
IP to the
frontend
component and it is necessary since the component runs in the docker network.
When both backend and frontend are in DEV mode, and the backend is running v4,
the
openapigenerator
is available
in the DEV environment, and an SDK generation can be triggered from withing the frontend container by running
generate_sdk
in the shell.