Skip to content

Commit 43ae357

Browse files
committed
📝 Update Readme
1 parent 4ed2c22 commit 43ae357

File tree

1 file changed

+43
-4
lines changed

1 file changed

+43
-4
lines changed

README.md

+43-4
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,51 @@
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:
210

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
425

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
645

746
- [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).
847

9-
## Type Support For `.vue` Imports in TS
48+
### Type Support For `.vue` Imports in TS
1049

1150
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.
1251

0 commit comments

Comments
 (0)