share2fedi/README.md at ea5db414625b0118050d0bd35974ddd4df5037e3

Archived

This repository has been archived on 2024-05-13. You can view files and clone it, but cannot push or open issues or pull requests.

Nikita Karamov 43e84ea53e

Improve README

2023-09-02 21:56:48 +02:00

3.7 KiB

Raw Blame History

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:

<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

Vercel, Netlify, Cloudflare Pages

Share₂Fedi was designed to run on Vercel, but you can also run it on Netlify or Cloudflare Pages. To deploy it yourself (it's free!), you can use the following buttons:

To deploy to Cloudflare Pages, fork the repo and follow the instructions.

Host it yourself

Self-hosting Share₂Fedi outside of Vercel requires some extra setup:

Prerequisites: modern Node.js (v16 or later), pnpm.

Install dependencies.
```
pnpm install
```
Build.
```
pnpm build
```
Run server.

By default, this will only listen on localhost port 3000. To enable listening on a ceratin host and/or port, set the HOST and PORT environment variables, respectively.
```
node dist/server/entry.mjs
```
In production, you might want to use a process manager, like PM2:
```
# Start the app, restart on file changes (except node_modules)
pm2 start dist/server/entry.mjs --name "Share2Fedi" --watch --ignore-watch="node_modules"
```
More information about self-hosting an Astro website with Node: https://docs.astro.build/en/guides/integrations-guide/node/#standalone
Set up a reverse proxy.

Basically, you need to run a reverse proxy that would redirect all incoming requests to localhost:3000. Here's how to achieve this in various HTTP servers:
1. Apache
```
ProxyPass "/" "http://localhost:3000/"
```
1. Nginx
```
location / {
    proxy_pass http://localhost:3000/;
}
```
1. Caddy
```
reverse_proxy :3000
```

Docker

If you really have to use Docker, there is a good guide on building Astro apps with Docker. I will not provide support for Docker-based deployments in the observable future.

Licence

This project is hosted on GitHub: https://github.com/kytta/share2fedi.git

3.7 KiB Raw Blame History Unescape Escape