Quasar App (top-frontend)

A Quasar Framework app

Development

Install the dependencies

1. Install npm and Quasar CLI, or use the .devcontainer/devcontainer.json configuration to build a Development Container.

2. The npm package @onto-med/top-api is hosted in the GitHub Packages registry, thus requires authentication.

   1. Create a personal access token (classic) at https://github.com/settings/tokens and give it access to read:packages.
   2. Optionally, export your token to the environment variable NPM_AUTH_TOKEN.
   3. Alternatively to the step above, you can authenticate at GitHub via npm login --scope=@onto-med --auth-type=legacy --registry=https://npm.pkg.github.com (if you use npm version 8 or lower, remove the argument --auth-type=legacy). You will now be prompted for your username and "password" (enter your personal access token, not your GitHub account password).
   4. For the devcontainer setup, you need to create a .devcontainer/.env file containing your GitHub personal access token (see .devcontainer/.env.dist)

3. Run npm install (skip this step in the devcontainer setup)

Start the app in development mode (hot-code reloading, error reporting, etc.)

bash npm run dev

You can specify the following environment variables via .env file or command line:

| variable name | default value | description | | --------------------------------- | ---------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- | | OAUTH2ENABLED | false | Enable or disable authentication via Keycloak | | OAUTH2URL | http://127.0.0.1:8081/ | Keycloak URL | | OAUTH2REALM | top-realm | Keycloak realm name | | OAUTH2CLIENTID | top-frontend | Keycloak client id | | APIURL | http://127.0.0.1:8080 | URL of top-backend | | GDPRNOTICE | false | Show GDPR notice | | GDPRPOLICYURL | | Policy URL that is linked from the GDPR notice | | SYSTEMNOTICE | | Text that should be displayed as system notice | | DOCUMENTSENABLED | false | Enable or disable document search | | TOPPHENOTYPICQUERYDOCBASEURL | https://onto-med.github.io/top-phenotypic-query/care/smith/top/topphenotypicquery/c2reasoner | This URL is used to generate deep links to functions and constants documentation |

Lint the files

bash npm run lint

Build the app for production

bash npm run build