112 lines
2.9 KiB
Markdown
112 lines
2.9 KiB
Markdown
<h1 align="center"><img src="assets/share2fedi.svg" width="520" height="160" alt="Share2Fedi"></h1>
|
||
|
||
> Instance-agnostic share page for the Fediverse.
|
||
|
||
**[Share₂Fedi]** allows you to share stuff on Mastodon, GoToSocial, Pleroma, and other federated social networks, instance-agnostic. Just type in the post text and the instance URL, and click ‘Post!’
|
||
|
||
Or, open this page with the prefilled `text` URL parameter—it will be automatically inserted into the text field. The same goes for the `instance` URL parameter. This can be used to build custom share buttons for the federated social networks:
|
||
|
||
```html
|
||
<a
|
||
href="https://s2f.kytta.dev/?text=Hello%20world!&instance=https%3A%2F%2Fmastodon.xyz"
|
||
>
|
||
Share on mastodon.xyz
|
||
</a>
|
||
```
|
||
|
||
The instance URL can be saved in your `localStorage` to be automatically appended if used later—handy!
|
||
|
||
## Hosting
|
||
|
||
### One-click Vercel deploy
|
||
|
||
**Share₂Fedi** is designed to run on [Vercel](https://vercel.com/).
|
||
To deploy it yourself (it's free!), you can use the following button:
|
||
|
||
[](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fkytta%2Fshare2fedi)
|
||
|
||
### Host it yourself
|
||
|
||
Self-hosting **Share₂Fedi** outside of Vercel requires some extra setup:
|
||
|
||
**Prerequisites:** modern Node.js (v16 or later), `pnpm`.
|
||
|
||
1. Install the dependencies:
|
||
|
||
```sh
|
||
pnpm install
|
||
```
|
||
|
||
2. Build the static files:
|
||
|
||
```sh
|
||
pnpm build
|
||
```
|
||
|
||
3. Run the backend server for the form:
|
||
|
||
```sh
|
||
node api/share.js
|
||
```
|
||
|
||
alternatively, if you want to run the process in the background:
|
||
|
||
```sh
|
||
pm2 start api/share.js --watch --ignore-watch="node_modules"
|
||
```
|
||
|
||
> You can find a summary for pm2 at: https://pm2.keymetrics.io/docs/usage/quick-start/
|
||
|
||
4. Set up a web server
|
||
|
||
Basically, you need to run a server that would proxy the requests to `/api/share`.
|
||
to the Node.js server you started. Here's how to achieve this in various HTTP
|
||
servers:
|
||
|
||
1. Apache
|
||
|
||
```apacheconf
|
||
DocumentRoot "<PATH_TO_SHARE2FEDI>/dist"
|
||
|
||
ProxyPass "/api/share" "http://localhost:8080/"
|
||
```
|
||
|
||
2. Nginx
|
||
|
||
```nginxconf
|
||
root <PATH_TO_SHARE2FEDI>/dist;
|
||
index.html;
|
||
|
||
location /api/share {
|
||
proxy_pass http://localhost:8080/;
|
||
}
|
||
```
|
||
|
||
3. Caddy
|
||
|
||
```caddy
|
||
root * <PATH_TO_SHARE2FEDI>/dist;
|
||
try_files index.html
|
||
|
||
handle_path /api/share {
|
||
reverse_proxy localhost:8080
|
||
}
|
||
```
|
||
|
||
## See also
|
||
|
||
**[📯 Shareon](https://shareon.js.org)**
|
||
(lightweight, stylish, and ethical share buttons) uses **Share₂Fedi** under the hood!
|
||
|
||
## Licence
|
||
|
||
© 2020–2022 [Nikita Karamov]\
|
||
Licensed under the [GNU Affero General Public License, version 3][AGPL-3.0].
|
||
|
||
---
|
||
|
||
This project is hosted on GitHub: <https://github.com/kytta/share2fedi.git>
|
||
|
||
[AGPL-3.0]: https://spdx.org/licenses/AGPL-3.0-only.html
|
||
[Nikita Karamov]: https://www.kytta.dev
|
||
[Share₂Fedi]: https://s2f.kytta.dev/
|