# eolas-app

A React web app that serves as the frontend for my Zettelkasten, Eolas.

eolas-app is a constituent part of my knowledge management system comprising [eolas](https://forgejo.systemsobscure.net/thomasabishop/eolas),
[eolas-db](https://forgejo.systemsobscure.net/thomasabishop/eolas-db), and [eolas-api](https://forgejo.systemsobscure.net/thomasabishop/eolas-api).

It sources its data from
[eolas-api](https://forgejo.systemsobscure.net/thomasabishop/eolas-api) also
running on my VPS.

## Local development

```sh
npm install
npm run dev
```

This will use Vite to start the application at `http://localhost:5173`. The
application requires a local instance of `eolas-api` to be running, specified
via the environment variable `VITE_EOLAS_API_ENDPOINT` in a `.env`.

Alternatively use the production API URL.

## Deployment

The application is deployed to my remote VPS, residing at `/var/www/eolas-app`.

It is publicly accessible at
[eolas.systemsobscure.net](https://eolas.systemsobscure.net).

Deployment is automated via a [Forgejo action](https://forgejo.systemsobscure.net/thomasabishop/eolas-app/src/branch/main/.forgejo/workflows/deploy.yaml) that builds the Webpack bundle
and transfers it to the VPS. Deployment actions are always executed by the `deploy` user on the VPS.