瀏覽代碼

chore: Add a small readme

Sean Blackburn 10 月之前
父節點
當前提交
a654db9893
共有 3 個文件被更改,包括 48 次插入4 次删除
  1. 47 4
      README.md
  2. 1 0
      cspell.config.yaml
  3. 二進制
      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

二進制
img/planer.png