Browser tools
Publish Hand and BUM Hand work with your own Micro.blog app token. No inbound email configuration required.
Set up the shared deployment ↓Self-hosting
Make it yours.
The browser tools are local-first. Your token is supplied when you publish and is not persisted by Helping Hand. Writing Hand is optional and adds server-side credentials only to your own deployment.
Quick reminder: Publish Hand and BUM Hand work without any email configuration. Writing Hand posts are drafts by default; only an explicit
Status: published line publishes immediately.What you need
For the browser tools: GitHub, Netlify, and a Micro.blog account if you want to publish. For Writing Hand as well: Resend with inbound email enabled, a private incoming email address, a dedicated Micro.blog app token, and Netlify Database.
1. Fork or clone
git clone https://github.com/davidmarsden/handwritten-publish.git
cd handwritten-publish
npm install
npm test
npm run buildFor local development:
npm run devThe suite uses Vite/React plus static product pages. Production output goes to dist/; server-side bridges live in netlify/functions/.
2. Deploy to Netlify
Create a Netlify project from your GitHub fork/repository.
| Setting | Value |
|---|---|
| Build command | npm run build |
| Publish directory | dist |
Netlify recognises the functions in netlify/functions/. The repository also contains a Netlify Database migration; Netlify provisions and applies it during deployment. If you only use the browser tools, leave all post-by-email environment variables unset.
3. Connect Micro.blog in the browser
Paste a Micro.blog app token into Publish Hand or BUM Hand when you want to publish or upload. The token is kept in browser memory and passed to the Netlify bridge only for the requested API calls; Helping Hand does not persist it in IndexedDB, portable documents or Netlify configuration.
Create Micro.blog app tokens under Account → App tokens / Edit Apps. If you have several Micro.blog-hosted blogs, Publish Hand uses Micropub destinations to let you select one. New browser-created posts start as private drafts.
4. Optional: enable Writing Hand
reMarkable
↓ Send by email
private Resend address
↓ email.received webhook
Netlify Function
↓
Micro.blog draft by default
or live post when Status: published is explicit
The detailed configuration is on the Writing Hand page. It includes every environment variable, the Resend webhook URL, routing examples and the handwritten title/category/status syntax.
Security summary
- Never commit Micro.blog or Resend tokens.
- Keep Writing Hand recipient addresses private; treat them as publishing credentials.
- Browser users supply their own Micro.blog token.
- Writing Hand uses a separate dedicated server-side Micro.blog token.
- Missing email
Status:always means draft.