summaryrefslogtreecommitdiff
path: root/pse-dashboard/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'pse-dashboard/README.md')
-rw-r--r--pse-dashboard/README.md83
1 files changed, 83 insertions, 0 deletions
diff --git a/pse-dashboard/README.md b/pse-dashboard/README.md
new file mode 100644
index 0000000..16ee1eb
--- /dev/null
+++ b/pse-dashboard/README.md
@@ -0,0 +1,83 @@
+# Podcast Synchronisation made Efficient Dashboard
+> Dashboard for PSE-Server
+
+## About
+
+The synchronization of the podcasts is to be managed via a web interface. For
+this purpose a single-page application will be created. This can be displayed in
+a user-friendly way for desktop and mobile devices.
+
+The web interface contains the subscribed podcasts and listened episodes
+including metadata from the backend.
+
+## Getting Started
+
+### Pre requirements
+
+- Node.js 19
+- npm
+
+### Install dependencies
+
+```sh
+$ npm install
+```
+
+### Run development server
+
+Runs dev server with live-preview
+
+```sh
+$ npm run dev
+```
+
+### Build to static files
+
+```sh
+$ npm run build
+```
+
+You can define that backend domain by editing the `.env.production` file or
+setting the environment variable.
+```sh
+$ VITE_BACKEND_URL=http://<YOUR BACKEND DOMAIN> npm run build
+```
+
+### Docker
+
+> Note that you are running the frontend standalone!
+> Checkout `pse-docker` to run both front- and backend.
+
+The docker image can be build using
+```sh
+$ docker build -t pse-frontend .
+```
+
+Here you can change the backend domain by editing the `Dockerfile` or by
+supplying it when building.
+```sh
+$ docker build --build-arg VITE_BACKEND_URL=http://<YOUR BACKEND DOMAIN> -t pse-frontend .
+```
+
+Then the image can be run using
+```sh
+$ docker run -p 80:80 -it pse-frontend
+```
+
+## Recommended IDE Setup
+
+- [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).
+
+## Used Dependencies
+
+- vite
+- vue
+- vue-router
+- bootstrap
+- fontawesome
+- vue-i18n (Support für mehrere Sprachen)
+
+## License
+
+This project is licensed under the AGPL-3 License - see the `LICENSE` file for details.
+