The Web interface for Peergos
We avoid JS based build tools and managers like npm, webpack etc. to maintain greater control over the build process. This allows us to achieve cross-platform reproducible builds and future proof our build system (we should be able to build any commit any number of years into the future with only a JVM). The one exception to this is precompiling vue.js templates, which is done using vue-template-compiler run in a vendored copy of GraalJS.
All our assets are vendored and served from a single domain, for improved privacy, security and reliability. We use a very simple custom replacement for webpack written in Java which can handle vue components, called JPack.
Most of the complex logic around encryption etc. is implemented in Java in the peergos submodule. This is all cross-compiled to JS using GWT during the compile_server target. We plan to upgrade this to J2CL when time and resources permit. Components are implemented as Vue 2 components in src/components.
Requires ant and Java 17 and at least 2 GB of RAM.
NB: all other dependencies are checked into the repo, or into the submodule peergos repo.
sudo apt install openjdk-17-jdk ant
brew install ant # installs openjdk as a dependency
ant -version
Apache Ant(TM) version 1.10.8 compiled on May 10 2020
ant dist
The output will be server/Peergos.jar
Package Peergos into a container image with:
docker build --file Containerfile --tag peergos:dev .
Then start Peergos inside the container with the following if you are proxying localhost:8000 to the docker container:
docker run --volume $(PEERGOS_PATH):/opt/peergos/data peergos:dev daemon -domain 0.0.0.0 -public-domain localhost:8000 -log-to-console true
# Build and run an ephemeral local Peergos server on https://localhost:8000
ant update_and_run
# or in dev mode - this disables CSP headers and vue template precompilation
ant update_and_run_dev
# This builds the ui in prod mode
ant ui
# This builds the ui in dev mode, this only works with the server in dev mode, otherwise vue is blocked by our CSP.
ant ui_dev
# This rebuilds the ui in dev mode whenever a file changes or is added in assets, vendor or src
ant watch_ui
Navigation between apps is driven by updating the URL fragment with an encrypted object, except for secret links which don't update the history
-
drive.openFile(writable) -> getApp(file, path, writable)
- isSecretLink ? drive.openInApp(args, app) OR openFileOrDir(app, path, args, writable)
-
openFileOrDir(app, path, args, writable) -> updateHistory
-
updateHistory(app, path, args, writable)
- put these fields into an encrypted object in the url fragment
-
onUrlChange
- set view from props decrypted from URL
- for non sidebar apps, call drive.openInApp(args, app)
-
drive.openInApp(args, app)
- set showX = true OR closeApps()