flaschengeist-frontend/README.md

1.8 KiB

Flaschengeist (frontend)

Modular student club administration system, licensed under the MIT license.

Installation

Requirements

 "engines": {
    "node": ">= 12.22.1",
    "npm": ">= 6.14.12",
    "yarn": ">= 1.21.1"
 }

So on debian (buster and bullseye) you will need to install node.js and yarn beside the debian packages to meet the needed versions.

pushd ~/opt
wget https://nodejs.org/dist/v16.2.0/node-v16.2.0-linux-x64.tar.xz
tar -xJf node-v16.2.0-linux-x64.tar.xz
export PATH="$(pwd)/node-v16.2.0-linux-x64/bin":"$PATH"
npm i -g yarn
npm i -g @quasar/cli
popd

Install the dependencies

yarn install

Be aware npm might not work.

Configure Plugins

Installing a plugin

Simply add it as a dependency and install it, for example installing the pricelist-plugin:

yarn add '@flaschengeist/pricelist'
yarn install

Enable / Disable a plugin

After installing a plugin you will have to enable it, this is done by adding it to the plugin.config.js file. For the example above the file should look like:

module.exports = [
  // pricelist plugin:
  '@flaschengeist/pricelist',
];

Remember to rebuild the project

Configure Backend

The application is using the API of the backend This access needs to be configured in `src/config.ts'->config.baseURL

  • either you do have a proxy webserver that maps the '/api' to the backend (http://localhost:5000) or
  • you do directly configure the backend there:baseURL: 'http://localhost:5000'. Be aware not committing this configuration.

Build the application

yarn quasar build

Development

Please refer to out development wiki.