ソースを参照

chore: Add a small readme

Sean Blackburn 10 ヶ月 前
コミット
a654db9893
3 ファイル変更48 行追加4 行削除
  1. 47 4
      README.md
  2. 1 0
      cspell.config.yaml
  3. BIN
      img/planer.png

+ 47 - 4
README.md

@@ -1,7 +1,50 @@
 # Modulplaner
 
-## Customization
+A module planer web UI.
 
-The `.env.development` file contains some default environment variables that may be
-customized during the building process by including a `.env.production` file with custom
-values.
+![planer](./img/planer.png)
+
+Made out of the frustration from using a 120 page long PDF to plan my next
+semester. Easily find your modules and when they take place, add them to your
+plan and share it with your colleagues.
+
+This repo only contains the frontend code. The data behind the modules must be
+provided by you. This is meant to be hosted inside of a webserver like nginx.
+
+## Features
+
+- Create one or more plans per semester
+- Share your plan by:
+  - Sharing a link
+  - Printing it
+- Filter by
+  - Module
+  - Building
+  - Time / weekday
+  - Room
+  - ...
+- Module dependencies
+- On site / hybrid / online only
+- See past lectures for a module
+- ...
+
+## Development
+
+### Docker
+
+```bash
+docker compose build
+# OR
+docker build -t modulplaner-ui .
+```
+
+> [!NOTE]
+>
+> Currently the `.env` has to be injected during the build phase. Otherwise,
+> certain texts / links will not work or be displayed.
+
+### Customization
+
+The `.env.development` file contains some default environment variables that may
+be customized during the building process by including a `.env.production` file
+with custom values.

+ 1 - 0
cspell.config.yaml

@@ -117,6 +117,7 @@ words:
   - MODULEGROUPS
   - moduleset
   - nachname
+  - nginx
   - nochecks
   - notiz
   - notna

BIN
img/planer.png