flaschengeist-frontend/README.md

63 lines
1.1 KiB
Markdown
Raw Normal View History

# Flaschengeist (frontend)
2019-12-20 12:45:37 +00:00
Modular student club administration system, licensed under the MIT license.
2020-10-02 07:13:14 +00:00
## Installation
### Install the dependencies
2020-10-02 07:13:14 +00:00
```bash
yarn install
2019-12-20 12:45:37 +00:00
```
### Configure Plugins
You can activate and deactive Plugins in `src/boot/plugins.ts`.
You have to set the name of the Plugin into `config.loadModules`.
### Build the application
```bash
yarn quasar build
2020-10-31 14:38:20 +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
### Commands useful for development
2020-10-31 14:38:20 +00:00
#### Start the app in development mode
2020-10-31 14:38:20 +00:00
Provides hot-code reloading, error reporting, etc.
2020-10-02 07:13:14 +00:00
```bash
yarn quasar dev
2019-12-20 12:45:37 +00:00
```
#### File linting
2020-10-02 07:13:14 +00:00
```bash
yarn run lint
2019-12-20 12:45:37 +00:00
```
### Plugins
#### 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
```
You have to import `FG_Plugin` from `plugins.d.ts`.