Share2Fedi

> 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 Share on mastodon.xyz ``` 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: [![Deploy with Vercel](https://vercel.com/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 "/dist" ProxyPass "/api/share" "http://localhost:8080/" ``` 2. Nginx ```nginxconf root /dist; index.html; location /api/share { proxy_pass http://localhost:8080/; } ``` 3. Caddy ```caddy root * /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]. The repo banner includes Mastodon’s ‘Full’ logo, licensed under [AGPL-3.0]. --- This project is hosted on GitHub: [AGPL-3.0]: https://spdx.org/licenses/AGPL-3.0-only.html [Nikita Karamov]: https://www.kytta.dev [Share₂Fedi]: https://s2f.kytta.dev/