55 lines (50 loc) · 2.14 KB

Relevant Repos

webext is the browser extension. It's just a shell for the main UI.
- comntr.github.io is the main UI. Most of the activity happens here. The extension renders this UI in an iframe when the user clicks on the extension icon.
  - captcha is the basic captcha service.
  - http-server is the main data server. It stores the comments.

How to debug the extension

Chrome can load the comntr/webext repo dir as an unpacked extension.
npm run xpi makes a xpi/comntr.xpi zip file that can be installed on Firefox desktop.
npm run xpi-prod makes a xpi/comntr.xpi zip file that can be published to addons.mozilla.org.
npm run adb-push creates a zip file on the connected Android device. It can be opened on Firefox Android at the file:///mnt/sdcard/WebExt/comntr.xpi URL.

How to create your own comntr server

Get a VPS. I used a DigitalOcean VPS with a LetsEncrypt cert.
Register your own domain: foobar.com.
Look for comntr.live in sources and use foobar.com instead.
Start the http server:
Push the http server bits to your VPS:
```
cd comntr/http-server
npm run ssh-push
```

SSH to the VPS and start the server:

ssh root@foobar.com
cd ~/comntr.io
npm start &
disown
exit

Check that the server is available at https://foobar.com:42751/.
Start the captcha service:
Push the captcha service bits to your VPS:
```
cd comntr/captcha
npm run rsync
```

SSH to the VPS and start the capctah service:

ssh root@foobar.com
cd ~/comntr/captcha
npm start &
disown
exit

Check that the service is available at https://foobar.com:2556/.
Fork comntr.github.io to your own username.github.io or serve the web app from your own domain, e.g. https://foobar:443/. Make sure that references to comntr.github.io are updated to the new domain name.
Publish your own copy of the extension:
```
cd comntr/webext
npm run xpi-prod
```