Onto-Med / top-frontend

JavaScript based frontend of the TOP Framework
MIT License
0 stars 1 forks source link
quasar-framework typescript vuejs

Quasar App (top-frontend)

A Quasar Framework app

Lint

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.)

quasar dev

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

variable name default value description
OAUTH2_ENABLED false Enable or disable authentication via Keycloak
OAUTH2_URL http://127.0.0.1:8081/ Keycloak URL
OAUTH2_REALM top-realm Keycloak realm name
OAUTH2_CLIENT_ID top-frontend Keycloak client id
API_URL http://127.0.0.1:8080 URL of top-backend
GDPR_NOTICE false Show GDPR notice
GDPR_POLICY_URL Policy URL that is linked from the GDPR notice
SYSTEM_NOTICE Text that should be displayed as system notice
DOCUMENTS_ENABLED false Enable or disable document search
TOP_PHENOTYPIC_QUERY_DOC_BASE_URL https://onto-med.github.io/top-phenotypic-query/care/smith/top/top_phenotypic_query/c2reasoner This URL is used to generate deep links to functions and constants documentation

Lint the files

npm run lint

Build the app for production

quasar build

Customize the configuration

See Configuring quasar.conf.js.