sake-app/README.md
2023-09-23 14:11:25 +02:00

2.4 KiB

Sub-Address KEy (SAKE) app

Web application that can be used to generate new sub-addresses as defined in the Sub-Address KEy (SAKE) filter.

Install

Download the build from the latest released version. Extract the archive and configure your web server to serve those files.

That's it. The final build is plain HTML/CSS/JS with a few assets, therefore there is no back-end to configure.

Alternatively, on ArchLinux you can install the sake-app package from the AUR. You will find the files in the /usr/share/webapps/sake-app directory.

Project Setup

npm install

Compile and Hot-Reload for Development

npm run dev

Compile and Minify for Production

npm run build

Frequently Asked Questions

Can I use this app without self-hosting it?

Yes, you can use https://sake.email/. This instance is kept up to date.

Can I use this app completely offline?

Currently, you only need the network connectivity to load the application. Once it's loaded, it can be used without access to the network.

In the future it may evolve in a progressive web application so it can be installed and used completely offline.

Where does this app stores my data?

Your data is exclusively stored in your browser's local storage. Nothing is sent over the network.

I use multiple devices, how do I synchronize my data?

Currently, because it is stored exclusively locally, you cannot synchronize your data.

This is a deliberate choice. In the future there may be a way to export it, but not automatically and in no circumstances over the network.

Do I have to write my secret-key by hand?

Not at all! If your key is represented by a QR code, you can scan it.

How do I generate a QR code with my key?

From the command line you can use the qrencode tool. Most Linux distributions and BSD systems have this tool in their packages or ports.

You can generate a new secret key and display it both in a base64 string and a QR code using the following command:

secret_key="$(openssl rand -base64 16)" && echo "Secret key: ${secret_key}" && qrencode -t utf8 "${secret_key}" && unset secret_key