Zachri Studio Tipnote docs
Overview
  1. Overview
  2. Install
  3. Using Tipnote
  4. Settings
  5. Click stats
  6. Security
  7. Privacy
  8. Changelog
  9. Support and licence

Tipnote

Tipnote is a free tip jar block for EmDash. Type /tipnote in a post and readers can tip you on the services you already use. Tipnote never touches the money.

Free on npm, no account or key: npm i @zachristudio/tipnote. See Install.

Requirements

  • EmDash 1.3 or later, on Astro 6 or later.
  • Post templates that render content with EmDash’s <PortableText>. The default templates already do.

What it does

  • Tip links to PayPal.me, Ko-fi, Buy Me a Coffee, GitHub Sponsors, Liberapay, Patreon or any https link. Readers pay on that service, so the money goes straight to you.
  • Six styles: Line, Card, Amounts, Goal, Providers and Pill. Pick a site default, and change it per block.
  • Suggested amounts. On PayPal.me the chosen amount is filled in for the reader. Other services ask for it on their own page.
  • A goal bar you update by hand, for serials and projects.
  • Click stats per post and tip link, kept in your own database. No cookies, and no IP addresses stored.
  • The block follows your theme’s font and text colour, on light and dark sites, with one accent colour you choose.

Free

Everything is free, on any number of sites. There’s no paid version.

Tipnote shows clicks, not tips: the services you link to don’t report payments back to it. If you want checkout on your own site, set amounts and a list of supporters, see Buyblock.

Why it installs from npm

Tipnote draws the block on your public pages. In EmDash only trusted plugins can do that, and trusted plugins install from npm, not from the registry. You add one line to astro.config.mjs. Its EmDash registry entry is a setup guide that points here.