|
1 |
| -# Vue 3 + TypeScript + Vite |
| 1 | +# Speiseplan Tray |
| 2 | +This is a small tray application for the [Speiseplan](https://studentenwerk.sh/de/mensen-in-luebeck?ort=3&mensa=8#mensaplan) of the [Studierendenwerk Schleswig Holstein](https://studentenwerk.sh). It is written in [TypeScript](https://www.typescriptlang.org/) and [Vue.js](https://vuejs.org/) and uses [Electron](https://www.electronjs.org/) to run as a tray application. \ |
| 3 | +It builds on top of this [Speiseplan API](https://speiseplan.mcloud.digital/). |
| 4 | +## Features |
| 5 | +- 💻 Tray application for Windows |
| 6 | +- 📅 Shows the menu for the current day |
| 7 | +- 🥬 Lets you filter by food type |
| 8 | +## Local Setup |
| 9 | +The following steps will get you up and running with a local development environment. We assume you have Node.js and npm installed: |
2 | 10 |
|
3 |
| -This template should help get you started developing with Vue 3 and TypeScript in Vite. The template uses Vue 3 `<script setup>` SFCs, check out the [script setup docs](https://v3.vuejs.org/api/sfc-script-setup.html#sfc-script-setup) to learn more. |
| 11 | +1. Clone the repo with |
| 12 | +```bash |
| 13 | +git clone https://github.com/Importantus/speiseplan-tray.git |
| 14 | +``` |
| 15 | +4. Change into the directory and install dependencies |
| 16 | +```bash |
| 17 | +cd speiseplan-tray |
| 18 | +npm install |
| 19 | +``` |
| 20 | +5. Start the local development server |
| 21 | +```bash |
| 22 | +npm run dev |
| 23 | +``` |
| 24 | +6. Install and use [gitmoji](#gitmoji) to commit |
4 | 25 |
|
5 |
| -## Recommended IDE Setup |
| 26 | +### Build |
| 27 | +Run `npm run build` to build the app for production. The build artifacts will be stored in the `release/` directory. |
| 28 | + |
| 29 | +### Gitmoji |
| 30 | + |
| 31 | +This project uses [gitmoji](https://gitmoji.carloscuesta.me/) to make commits more expressive. |
| 32 | + |
| 33 | +#### Installation |
| 34 | + |
| 35 | +```bash |
| 36 | +npm install -g gitmoji-cli |
| 37 | +``` |
| 38 | + |
| 39 | +#### Initialize as git hook |
| 40 | + |
| 41 | +```bash |
| 42 | +gitmoji -i |
| 43 | +``` |
| 44 | +### Recommended IDE Setup |
6 | 45 |
|
7 | 46 | - [VS Code](https://code.visualstudio.com/) + [Volar](https://marketplace.visualstudio.com/items?itemName=Vue.volar) (and disable Vetur) + [TypeScript Vue Plugin (Volar)](https://marketplace.visualstudio.com/items?itemName=Vue.vscode-typescript-vue-plugin).
|
8 | 47 |
|
9 |
| -## Type Support For `.vue` Imports in TS |
| 48 | +### Type Support For `.vue` Imports in TS |
10 | 49 |
|
11 | 50 | TypeScript cannot handle type information for `.vue` imports by default, so we replace the `tsc` CLI with `vue-tsc` for type checking. In editors, we need [TypeScript Vue Plugin (Volar)](https://marketplace.visualstudio.com/items?itemName=Vue.vscode-typescript-vue-plugin) to make the TypeScript language service aware of `.vue` types.
|
12 | 51 |
|
|
0 commit comments