2021-04-02 20:31:07 +00:00
|
|
|
# Flaschengeist (frontend)
|
2019-12-20 12:45:37 +00:00
|
|
|
|
2021-04-02 20:31:07 +00:00
|
|
|
Modular student club administration system, licensed under the MIT license.
|
2020-10-02 07:13:14 +00:00
|
|
|
|
2021-04-02 20:31:07 +00:00
|
|
|
## Installation
|
|
|
|
|
|
|
|
### Install the dependencies
|
2021-04-02 02:41:49 +00:00
|
|
|
|
2020-10-02 07:13:14 +00:00
|
|
|
```bash
|
2020-11-24 16:29:40 +00:00
|
|
|
yarn install
|
2019-12-20 12:45:37 +00:00
|
|
|
```
|
|
|
|
|
2021-04-02 20:31:07 +00:00
|
|
|
### Configure Plugins
|
2021-04-02 02:41:49 +00:00
|
|
|
|
2021-04-02 20:31:07 +00:00
|
|
|
You can activate and deactive Plugins in `src/boot/plugins.ts`.
|
|
|
|
You have to set the name of the Plugin into `config.loadModules`.
|
2021-04-02 02:41:49 +00:00
|
|
|
|
2021-04-02 20:31:07 +00:00
|
|
|
### Build the application
|
2021-04-02 02:41:49 +00:00
|
|
|
|
2021-04-02 20:31:07 +00:00
|
|
|
```bash
|
|
|
|
yarn quasar build
|
2020-10-31 14:38:20 +00:00
|
|
|
```
|
|
|
|
|
2021-04-02 20:31:07 +00:00
|
|
|
## Development
|
|
|
|
|
|
|
|
### Icons used
|
|
|
|
|
|
|
|
We are using the `mdi-v5` icon set, so feel free to use any icon from it.
|
|
|
|
A list can be found [here](https://materialdesignicons.com/)
|
2020-10-31 14:38:20 +00:00
|
|
|
|
2021-04-02 20:31:07 +00:00
|
|
|
### Commands useful for development
|
2020-10-31 14:38:20 +00:00
|
|
|
|
2021-04-02 20:31:07 +00:00
|
|
|
#### Start the app in development mode
|
2020-10-31 14:38:20 +00:00
|
|
|
|
2021-04-02 20:31:07 +00:00
|
|
|
Provides hot-code reloading, error reporting, etc.
|
2021-04-02 02:41:49 +00:00
|
|
|
|
2020-10-02 07:13:14 +00:00
|
|
|
```bash
|
2020-11-24 16:29:40 +00:00
|
|
|
yarn quasar dev
|
2019-12-20 12:45:37 +00:00
|
|
|
```
|
|
|
|
|
2021-04-02 20:31:07 +00:00
|
|
|
#### File linting
|
2021-04-02 02:41:49 +00:00
|
|
|
|
2020-10-02 07:13:14 +00:00
|
|
|
```bash
|
2020-11-24 16:29:40 +00:00
|
|
|
yarn run lint
|
2019-12-20 12:45:37 +00:00
|
|
|
```
|
|
|
|
|
2021-04-02 20:31:07 +00:00
|
|
|
### Plugins
|
2021-04-02 02:41:49 +00:00
|
|
|
|
2021-04-02 20:31:07 +00:00
|
|
|
#### Build a Plugin
|
|
|
|
|
|
|
|
A Flaschengeist-Frontend-Plugin should be placed in `src/plugins`.
|
|
|
|
It needs a `plugin.ts` File which exports a plugin with the following interface:
|
|
|
|
|
|
|
|
```
|
|
|
|
name: string;
|
|
|
|
mainRoutes?: PluginRouteConfig[];
|
|
|
|
outRoutes?: PluginRouteConfig[];
|
|
|
|
requiredModules: string[];
|
|
|
|
version: string;
|
2019-12-20 12:45:37 +00:00
|
|
|
```
|
2021-04-02 20:31:07 +00:00
|
|
|
|
|
|
|
You have to import `FG_Plugin` from `plugins.d.ts`.
|