2019-12-20 22:54:32 +02:00
|
|
|
SimpleLogin Chrome/Firefox extension
|
|
|
|
|
---
|
2020-01-01 22:57:50 +01:00
|
|
|
<p>
|
|
|
|
|
<a href="https://chrome.google.com/webstore/detail/simplelogin-protect-your/dphilobhebphkdjbpfohgikllaljmgbn">
|
|
|
|
|
<img src="https://img.shields.io/chrome-web-store/rating/dphilobhebphkdjbpfohgikllaljmgbn?label=Chrome%20Extension">
|
|
|
|
|
</a>
|
|
|
|
|
|
|
|
|
|
<a href="https://addons.mozilla.org/en-GB/firefox/addon/simplelogin/">
|
|
|
|
|
<img src="https://img.shields.io/amo/rating/simplelogin?label=Firefox%20Add-On&logo=SimpleLogin">
|
|
|
|
|
</a>
|
|
|
|
|
|
|
|
|
|
<a href="./LICENSE">
|
|
|
|
|
<img src="https://img.shields.io/github/license/simple-login/app">
|
|
|
|
|
</a>
|
|
|
|
|
|
|
|
|
|
</p>
|
2019-12-01 23:49:25 +00:00
|
|
|
|
2019-12-20 22:54:32 +02:00
|
|
|
SimpleLogin is the **open-source** privacy-first email alias and Single Sign-On (SSO) Identity Provider.
|
2019-12-01 23:49:25 +00:00
|
|
|
|
2020-01-01 22:57:50 +01:00
|
|
|
More info on our website at https://simplelogin.io
|
2019-12-20 22:54:32 +02:00
|
|
|
|
|
|
|
|
The extension uses VueJS with https://github.com/Kocal/vue-web-extension boilerplate.
|
|
|
|
|
|
|
|
|
|
## General information
|
|
|
|
|
|
|
|
|
|
The extension consists of 3 main screens:
|
|
|
|
|
|
|
|
|
|
- setup screen for first-time user. Here user can create and paste the `API Key` that's stored in `chrome.storage`.
|
|
|
|
|
- main screen: displays email alias recommendation, alias creation and existing alias.
|
|
|
|
|
- new alias screen: when a new alias is created, user is redirected to this screen so they can copy it.
|
|
|
|
|
|
|
|
|
|
## Contributing Guide
|
|
|
|
|
|
|
|
|
|
All work on SimpleLogin Chrome/Firefox extension happens directly on GitHub.
|
|
|
|
|
|
|
|
|
|
To run the extension locally, please follow these steps:
|
|
|
|
|
|
|
|
|
|
- install all dependencies with `npm install`.
|
|
|
|
|
|
2020-09-11 17:13:12 +02:00
|
|
|
- run `npm start` to generate the `/dist` folder that can be installed into Chrome.
|
2019-12-01 23:49:25 +00:00
|
|
|
|
2020-09-03 19:48:38 +02:00
|
|
|
On Firefox, it can be done via `web-ext` tool from within the `/dist` folder:
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
( cd dist/ ; web-ext run )
|
|
|
|
|
```
|
2019-12-01 23:49:25 +00:00
|
|
|
|
2021-08-03 16:37:08 +02:00
|
|
|
The code is formatted using `prettier`, make sure to run it before creating the commit:
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
npm run prettier:write
|
|
|
|
|
```
|
2020-07-29 23:06:05 +02:00
|
|
|
|
|
|
|
|
|
2021-08-03 16:41:57 +02:00
|
|
|
## Release
|
|
|
|
|
|
|
|
|
|
- Increment the version in `package.json`
|
|
|
|
|
- Update CHANGELOG with the changes
|
|
|
|
|
- Build the production version and zip it via
|
2020-11-13 18:51:43 +01:00
|
|
|
|
2020-07-30 17:37:46 +02:00
|
|
|
```bash
|
|
|
|
|
npm run build && npm run build-zip
|
|
|
|
|
```
|
2020-07-29 23:06:05 +02:00
|
|
|
|
2021-08-03 16:41:57 +02:00
|
|
|
- (Optional, only useful for beta build) Build beta version: change `betaRev` in `package.json`, then generate zip file using
|
2020-07-30 17:37:46 +02:00
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
npm run build:beta && npm run build-zip
|
|
|
|
|
```
|
2021-08-03 16:41:57 +02:00
|
|
|
|
|
|
|
|
- Upload to Chrome, Firefox, Edge stores.
|
