Freedback
Everything deserves feedback โ especially when people are impacted.
โถ Try the live widgets Read the White Book Source on GitHub
See it in action
- Widget showcase โ the five drop-in widgets (stars, thumbs, scalar, comments, tags), live against the demo server.
- Annotate anything โ attach feedback to a law, a Wikipedia article, an arbitrary web page (targets are just URIs).
- Collect feedback (data collection) โ a portable talk-feedback form you can export to CSV / JSON-LD.
- Questionnaire โ a multi-section survey built from drop-in widgets, with a live results summary.
- Barcode โ rate a real product by scanning its barcode (live server).
What it is
We can't force every organization to open a feedback channel โ so we make our own. Freedback is a federated, open protocol for attaching feedback โ stars, scalar ratings, thumbs, comments, tags โ to anything with a URI. Each entry is a standard W3C Web Annotation, published to a server you choose and aggregated across servers. No central gatekeeper.
And your feedback is yours. You sign it with your own portable key, so it is never locked inside the silo that collected it. Only you can edit it. Only you can delete it โ and deletion really erases. Queries follow subjects, not people: we aggregate opinions about things, we don't build profiles of users.
This doesn't depend on everyone adopting it at once. A federated protocol only matters once a critical mass shows up โ so Freedback is built to be worth using today, one project at a time, before that mass ever arrives: a widget you drop into an existing page, a feedback form that exports clean standard data, a wire format existing annotation tools already read. We also prefer standards over invention wherever one already exists โ Web Annotations, JSON-LD, schema.org, SHACL โ so almost nothing here is proprietary to Freedback itself. The federation is the long game; each individual use has to earn its keep now, on its own.
Want the whole story โ the vision, the architecture, and the reasoning behind every design decision? Read through the docs.
Feedback on Freedback
We dogfood: the software we ship to collect feedback collects feedback about the project itself โ right here, for real.
Protocol artifacts (stable URLs)
- JSON-LD
@contextโ/ns/context.jsonld - Vocabulary โ
/ns/freedback.ttl(rating subclasses ofschema:Rating) - SHACL shapes โ
/ns/shapes.ttl(all validation lives here) - Validation profile โ
/profile/1(dcterms:conformsTo) - Drop-in widget script โ
/widgets/freedback-widgets.js