yrdsl

Source for yrdsl.app. A yrdsl sale is one web page listing things you want to sell: photos, prices, short descriptions, and contact buttons for email, SMS, and WhatsApp. Buyers message you directly. No cart, no checkout, no payments.

Two ways to run a sale

Hosted

Sign up at yrdsl.app. Signs in with email. Supports multiple sales per account. Photos upload through the browser.

Self-hosted

The yrdsl-self-hosted template runs on GitHub Pages. No account.

1. Open the template repo and click Use this template.
2. In your new repo's Settings, enable GitHub Pages. Every push rebuilds the site at https://<you>.github.io/<repo>/.
3. sale.json holds the sale title, contact info, and theme. items.json is the list of items. Photos go in public/photos/. Edit and push.

Example sale: https://mreider.github.io/yrdsl-example/.

Data is portable. Hosted and self-hosted use the same JSON shapes, so you can move a sale between them.

Claude / MCP

Both modes ship with an MCP (Model Context Protocol) server so you can edit your sale from Claude instead of the editor form.

• Hosted: see the Connect Claude tab in the app. It gives you a key and two install paths (Claude Desktop extension, Claude Code command).
• Self-hosted: the MCP reads and writes the repo on disk. Setup lives in the template repo's README.

Contact

matt@mreider.com.

Contributing

Dev setup, running locally, and tests: CONTRIBUTING.md. Hosted deployment details: ops/HOSTED-DEPLOY.md.

License

Apache 2.0. Operated by Kuvop LLC.