2021-08-21 01:39:54 +02:00
[![jest ](https://jestjs.io/img/jest-badge.svg )](https://github.com/facebook/jest)
[![code style: prettier ](https://img.shields.io/badge/code_style-prettier-ff69b4.svg?style=flat-square )](https://github.com/prettier/prettier)
[![PRs Welcome ](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square )](https://github.com/davidnguyen179/web-extension-boilerplate/pulls)
![ci/cd ](https://github.com/davidnguyen179/web-extension-boilerplate/workflows/ci/cd/badge.svg )
# ![img](https://gitlab.com/uploads/-/system/project/avatar/16473487/logo-min.png) Fedishare
2021-01-08 04:48:30 +01:00
2021-01-08 09:50:15 +01:00
Share the current tab on the [fediverse ](https://fediverse.party/ ).
2021-01-08 04:48:30 +01:00
2021-08-21 01:39:54 +02:00
## Get the extension TODO
### Gecko
| Firefox Browser Add-ons | Trisquel Web Browser Add-ons |
---|---
[![img ](https://upload.wikimedia.org/wikipedia/commons/thumb/a/a0/Firefox_logo%2C_2019.svg/77px-Firefox_logo%2C_2019.svg.png )](https://addons.mozilla.org/en-US/firefox/addon/fedishare-addon) | ![img ](https://trisquel.info/files/avatars/picture-1.png )
### Blink
2021-01-08 04:48:30 +01:00
2021-08-21 01:39:54 +02:00
| Chrome Web Store | Opera addons |
---|---
![img ](https://storage.googleapis.com/chrome-gcs-uploader.appspot.com/image/WlD8wC6g8khYWPJUsQceQkhXSlv1/tbyBjqi7Zu733AAKA5n4.png ) | ![img ](https://addons-static.operacdn.com/static/header-footer/css/img/opera-addons.png )
2021-01-08 04:48:30 +01:00
2021-01-08 09:01:57 +01:00
## Features
2021-01-08 16:41:56 +01:00
Simplest add-on for the fediverse. Share web pages right from the toolbar button.
2021-08-21 01:39:54 +02:00
### Supported services/protocols:
2021-01-08 16:41:56 +01:00
- Diaspora
- Friendica
2021-08-21 01:39:54 +02:00
- Gnusocial
- Hubzilla / Zap
2021-01-08 16:41:56 +01:00
- Lemmy
2021-08-21 01:39:54 +02:00
- Mastodon / Misskey
2021-01-08 16:41:56 +01:00
- Pleroma
2021-08-21 01:39:54 +02:00
- Socialhome
2021-01-08 16:41:56 +01:00
- XMPP
2021-01-08 09:01:57 +01:00
## Contributing
You can contribute in the following ways:
2021-08-21 01:39:54 +02:00
- Finding and reporting bugs.
- Contributing code to the project by fixing bugs or implementing features.
2021-01-08 09:01:57 +01:00
### Bug reports
Bug reports and feature suggestions can be submitted to [Gitlab Issues ](https://gitlab.com/mickie1/share-freedom-extension/issues ). Please make sure that you are not submitting duplicates, and that a similar report or request has not already been resolved or rejected in the past using the search function. Please also use descriptive, concise titles.
### Pull request
Please use clean, concise titles for your pull requests.
2021-08-21 01:39:54 +02:00
## Build
2021-01-08 09:01:57 +01:00
2021-08-21 01:39:54 +02:00
This project uses the [Web Extension Boilerplate ](https://github.com/davidnguyen179/web-extension-boilerplate ).
2021-01-08 09:01:57 +01:00
2021-08-21 01:39:54 +02:00
### Prerequisites
2021-01-08 16:41:56 +01:00
2021-08-21 01:39:54 +02:00
Gecko
- Mozilla Firefox 59 (or higher)
2021-01-08 16:41:56 +01:00
2021-08-21 01:39:54 +02:00
**Install all dependencies:** `npm i`
2021-01-08 16:41:56 +01:00
2021-08-21 01:39:54 +02:00
### Development
2021-01-08 09:01:57 +01:00
2021-08-21 01:39:54 +02:00
##### Chrome
2021-01-08 09:01:57 +01:00
2021-08-21 01:39:54 +02:00
- Dev: `npm run app:chrome-dev`
- Production: `npm run app:chrome`
2021-01-08 09:01:57 +01:00
2021-08-21 01:39:54 +02:00
##### Edge
2021-01-08 09:50:15 +01:00
2021-08-21 01:39:54 +02:00
- Dev: `npm run app:edge-dev`
- Production: `npm run app:edge`
2021-01-08 09:50:15 +01:00
2021-08-21 01:39:54 +02:00
##### Firefox
2021-08-18 06:57:59 +02:00
2021-08-21 01:39:54 +02:00
- Dev: `npm run app:firefox-dev`
- Production: `npm run app:firefox`
2021-08-18 06:57:59 +02:00
2021-08-21 01:39:54 +02:00
#### Load package to browsers
2021-08-18 06:57:59 +02:00
2021-08-21 01:39:54 +02:00
1. Go to the browser's URL address bar
2021-08-18 06:57:59 +02:00
2021-08-21 01:39:54 +02:00
In Chrome:
2. Enter `chrome://extensions`
2021-08-18 06:57:59 +02:00
2021-08-21 01:39:54 +02:00
In Edge:
2. Enter `edge://extensions`
2021-08-18 06:57:59 +02:00
2021-08-21 01:39:54 +02:00
In Firefox:
2. Enter `about:debugging#/runtime/this-firefox`
2021-08-18 06:57:59 +02:00
2021-08-21 01:39:54 +02:00
In Chrome and Edge:
3. Turn on "**Developer mode**"
4. Load extension by clicking "**Load unpacked**"
5. Browse to `dist/` in source code.
2021-08-18 06:57:59 +02:00
2021-08-21 01:39:54 +02:00
In Firefox:
3. Click **Load Temporary Add-on...**
4. Browse to your `manifest.json` & click **Open**
2021-08-18 06:57:59 +02:00
2021-08-21 01:39:54 +02:00
#### CSS
2021-08-18 06:57:59 +02:00
2021-08-21 01:39:54 +02:00
[tailwindcss ](https://tailwindcss.com ) is the framework used for this project.
2021-08-18 06:57:59 +02:00
2021-08-21 01:39:54 +02:00
- Dev: `npm run style-dev`
- Production: `npm run style`
2021-08-18 06:57:59 +02:00
2021-08-21 01:39:54 +02:00
Set all css custom in: `public/styles.css` . The `main.css` is generated in `dist` .
2021-08-18 06:57:59 +02:00
2021-08-21 01:39:54 +02:00
## Donations
2021-08-18 06:57:59 +02:00
2021-08-21 01:39:54 +02:00
__Bitcoins:__ bc1qf7v8zty2yz8phulet29wcpxjclvffn5w6ry43w
2021-08-18 06:57:59 +02:00
2021-08-21 01:39:54 +02:00
__Ethereum:__ 0xca2FD9C3834694E2cB3db3bf79b3AfB083bA6732
2021-08-18 06:57:59 +02:00
2021-08-21 01:39:54 +02:00
## License
2021-08-18 06:57:59 +02:00
2021-08-21 01:39:54 +02:00
[![Large GPLv3 logo with “Free as in Freedom” ](https://www.gnu.org/graphics/gplv3-with-text-136x68.png )](http://www.gnu.org/licenses/gpl-3.0.en.html)
2021-08-18 06:57:59 +02:00
2021-08-21 01:39:54 +02:00
Copyright (C) 2019-2021 Miguel (aka mickie) < millet @ tuta . io >
This file is part of Fedishare.
Fedishare is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see < http: / / www . gnu . org / licenses / > .
2021-08-18 06:57:59 +02:00