🐘 Cross-instance share page for Mastodon https://toot.kytta.dev/
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
Nikita Karamov 911f27f54a
Correct self-hosting instructions (#5)
2 weeks ago
.github Update usernames 7 months ago
api Update years in licence headers 6 months ago
assets Update toot logo to be more Mastodon-like 2 years ago
src Fix font naming 5 months ago
.browserslistrc Move browserslist to separate file 2 years ago
.editorconfig Add EditorConfig 2 years ago
.gitignore Change output directory to public 12 months ago
.node-version Migrate from asdf to nodenv 1 year ago
.prettierignore Update .prettierignore 12 months ago
.prettierrc.json Use Prettier to format files 1 year ago
CHANGELOG.md Fix font naming 5 months ago
LICENSE Migrate license from MIT to AGPL-3.0 2 years ago
README.md add caddy syntax 3 months ago
gulpfile.js Change output directory to public 12 months ago
package.json v2.3.1 5 months ago
pnpm-lock.yaml Bump some dependencies 6 months ago

README.md

toot

Cross-instance share page for Mastodon

toot allows you to share stuff on Mastodon, cross-instance. Just put in your post text and the instance URL and click ‘Toot!’

And if you open this page with text URL parameter, it will be auto-inserted in the text field. The same goes for the instance URL parameter. This can be used to build custom share buttons for Mastodon:

<a href="https://toot.kytta.dev/?text=Hello%20world!&instance=https%3A%2F%2Fmastodon.xyz">
  Share on Mastodon
</a>

The instance URL can be saved in your localStorage to be automatically appended later — handy!

Hosting

One-click Vercel deploy

For now, toot is a tad bit vendor-locked to run on Vercel. To deploy it yourself, you can use the following button:

Deploy with Vercel

Host it yourself

Self-hosting toot outside of Vercel requires some extra setup:

  1. Make sure you have got Node.js v12 or later as well as pnpm installed

  2. Build the static part of toot:

    pnpm install    # to install dependencies
    pnpm run build  # to build the website
    
  3. Run the backend server for the form:

    node api/toot.js
    

    or if you want to run the process in the background:

    pm2 start api/toot.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 webserver

    1. Apache
    DocumentRoot "path_to_toot/public"
    
    ProxyPass "/api/toot"  "http://localhost:8000/"
    
    1. Nginx
    root path_to_toot/public;
    index.html;
    
    location /api/toot {
        proxy_pass http://localhost:8000/;
    }
    
    1. Caddy
    root * path_to_toot/public;
    try_files index.html
    
    handle_path /api/toot {
       reverse_proxy localhost:8000
    }
    

See also

📯 Shareon (lightweight, stylish, and ethical share buttons) uses toot under the hood!

Licence

Copyright © 2020–2022 Nikita Karamov
Licenced under the GNU Affero General Public License, version 3

The ‘toot’ logo is based on Mastodon’s ‘Simple’ logo, licensed under AGPL-3.0.

The repo banner includes Mastodon’s ‘Full’ logo, licensed under AGPL-3.0.


This project is hosted on Codeberg: https://codeberg.org/kytta/toot