Management system for student clubs
Go to file
Ferdinand Thiessen 308d348755
continuous-integration/woodpecker the build was successful Details
feat(ci): Added woodpecker CI
2021-12-08 15:17:25 +01:00
.vscode [Vue3][pinia] Make pricelist compile with vue3, needs more work! 2021-03-19 16:33:27 +01:00
.woodpecker feat(ci): Added woodpecker CI 2021-12-08 15:17:25 +01:00
api fix(api): Allow userid as parameter for avatarURL 2021-12-06 12:51:47 +01:00
public [pricelist][picture] update picture if changed, add no-image.svg 2021-03-28 11:34:36 +02:00
src fix(boot): Fix navigation guards so users get redirected after logging in 2021-12-06 13:14:42 +01:00
src-capacitor chore(format): Fix formatting, enforce prettier style 2021-12-06 00:40:50 +01:00
src-electron [cleanup] Fix some minor formatting 2021-11-11 11:11:06 +01:00
.editorconfig new Project with Quasar 2020-10-02 09:13:14 +02:00
.eslintignore Use yarn and updated dependencies 2020-11-24 17:34:12 +01:00
.eslintrc.js chore(format): Fix formatting, enforce prettier style 2021-12-06 00:40:50 +01:00
.gitignore [capacitor] disable allowLinkPreview for ios 2021-11-26 22:13:35 +01:00
.postcssrc.js chore(format): Fix formatting, enforce prettier style 2021-12-06 00:40:50 +01:00
LICENSE [core] Added license and fixed links in package.json 2021-04-02 04:41:49 +02:00
README.md [docs] Add notes on cordova, different browser targets 2021-11-23 15:59:16 +01:00
babel.config.js chore(format): Fix formatting, enforce prettier style 2021-12-06 00:40:50 +01:00
package.json fix(boot): Fix navigation guards so users get redirected after logging in 2021-12-06 13:14:42 +01:00
plugin.config.js [docs][core] Move devel docs to wiki, use correct api package 2021-05-26 18:49:36 +02:00
quasar.conf.js chore(format): Fix formatting, enforce prettier style 2021-12-06 00:40:50 +01:00
tsconfig.json [core] Seperated all plugins from the main source tree 2021-05-25 16:13:15 +02:00

README.md

Flaschengeist (frontend)

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

Installation

Requirements

 "engines": {
    "node": ">= 14.18.1",
    "npm": ">= 6.14.12",
    "yarn": ">= 1.22.0"
 }

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/latest-v16.x/node-v16.13.0-linux-x64.tar.xz
tar -xJf node-v16.13.0-linux-x64.tar.xz
export PATH="$(pwd)/node-v16.13.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

Notes on mobile apps (Cordova)

For mobile applications older web engines should or must be supported, as manufaturer often do not update their phones, so for building cordova apps set the BROWSERSLIST_ENV environment variable to BROWSERSLIST_ENV=cordova. This will produce ECDMAscript compatible with iOS 13+ and Android Webview 76 (relased October 2019).

Development

Please refer to our development wiki.