Skip to main content
Fridge Notes is the smallest useful Publish integration: a local notes server that makes itself reachable through Meradomo and greets each visitor by their verified email.

Source

examples/fridge-notes/ — MIT-licensed. Two files: server.js and README.md.

Run it

cd examples/fridge-notes
node server.js
Approve Fridge Notes in the menu-bar app, then open the printed https://notes.<your-name>.meradomo.com.

The two integration points

1. Self-publish on launch — one HTTP call, then poll until live:
const res = await fetch('http://127.0.0.1:8765/publish', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({ name: 'notes', label: 'Fridge Notes', localPort: port }),
});
// 202 pending → poll GET /publish/notes until { status: 'live', url }
2. Read identity from the header the agent injects — no sign-in code:
const email = req.headers['x-meradomo-email'] || null;   // verified, non-forgeable
That’s the whole integration. See Agent API for the full publish lifecycle and Security model for why the header can be trusted.