IllusionFeedback · free · self-hosted

Feedback developers can actually work with.

One script on your website, one button for your testers. They mark what’s wrong – you get the screenshot, console, network, request IDs and the seconds before as a replay.

One Go binary, one SQLite file. No SaaS, no cookies.

IllusionFeedback – Widget: marking up an area in the screenshot
1
line to embed
60 s
of session replay before the report
0
cookies for testers
5
languages in widget and dashboard
Embed

One line, done.

Create a project in the dashboard, copy the embed code, paste it into your page. Works with any web project – static site, single-page app or server rendering.

  • Widget in the shadow DOM: it never bends your page’s styles
  • Optional identify() for signed-in users and setRelease() for your version
  • Language follows the page, button customizable per project
index.html
<script src="https://feedback.example.com/embed.js"
        data-project="<project-key>" defer></script>

<script>
  // optional
  IllusionFeedback.identify({ id: "42", name: "Erika Muster" });
  IllusionFeedback.setRelease("2026-11-10");
</script>
Features

From the tester's click to the fix.

Everything between “something’s wrong” and “it’s fixed” – in one place, on your server.

For testers

Show, don't describe.

Drag over an area of the page, mark it up in the screenshot, add a sentence, send. No account, no browser extension, no screen sharing prompt.

  • Box, arrow, text and redaction right in the widget
  • Screenshot rendered from the DOM, password fields blacked out automatically
  • Pick a type: bug, idea, question or praise
IllusionFeedback – Widget: form with screenshot preview
For developers

Everything at a glance.

Every report comes with the screenshot and its markup, comment, tester and environment: URL, browser, window, language, release.

  • Copy as text or as a prompt – ready for a ticket or an AI assistant
  • Internal notes and public replies to the tester kept apart
  • Filters, search and status in the URL – views can be shared
IllusionFeedback – Dashboard: report with annotated screenshot
Context

The context comes by itself.

From the moment it loads, the widget collects technical traces in memory – sent only together with a report.

  • Steps, console, errors and network in one timeline
  • Request IDs from X-Request-Id, traceparent, Server-Timing & co. – linked to your logs
  • Stack traces resolved via source maps, with a code excerpt
IllusionFeedback – Dashboard: timeline with steps, console, errors and network
Session replay

The seconds before.

The last 60 seconds or so before the report as a replayable recording – clicks, scrolling, DOM changes. Clicking an error in the timeline jumps to the same moment.

  • Enabled per project, loads no code otherwise
  • Inputs always masked, all text on request
  • In memory only, sent only with a report
IllusionFeedback – Dashboard: session replay with masked text
Tickets

From hint to ticket.

Turn reports into a ticket with one click or attach them to an existing one – duplicates end up with the same problem.

  • Kanban with Open, In progress, Test and Done
  • Assignees, priority, deadline and history
  • Known issues optionally visible in the widget – testers click “affects me too”
IllusionFeedback – Dashboard: ticket board
Test tasks

Tell testers what to test.

Test tasks show up in the widget as a checklist: worked, report a problem or skipped. The dashboard shows who tested what.

  • Tasks with steps, start URL, time frame and audience
  • “My reports”: testers see the status and your reply
  • Optional email when something is done
IllusionFeedback – Widget: test tasks as a checklist
Error tracking

Errors, before anyone reports them.

Once enabled, the widget captures JavaScript errors and failed requests without a single click – grouped into error groups.

  • Occurrences, affected users, releases and examples with context
  • Source map upload: file, line and code instead of a minified stack
  • Regressions: if a resolved error comes back, it’s open again
IllusionFeedback – Dashboard: error group with resolved stack trace
Releases

Every release in view.

Reports, errors and affected users per version – and which error groups a release introduced.

  • Compare two releases side by side
  • Filter by release in the inbox, errors and tickets
  • No upkeep: releases come from setRelease() and your source maps
IllusionFeedback – Dashboard: releases compared
MCP server

Your AI assistant reads along.

IllusionFeedback ships with an MCP server. Claude Code, Claude Desktop or any other MCP client uses your token to access reports, error groups and tickets directly.

  • “Look at the new report and fix it” – including screenshot and timeline
  • Read or write tokens: create, move and comment on tickets
  • No API key and no costs on your instance
terminal
$ claude mcp add --transport http illusionfeedback \
    https://feedback.example.com/mcp \
    --header "Authorization: Bearer ifb_…"

> Look at the latest report
  and fix the bug.
Privacy

Data-minimal by default.

Your testers should be able to trust you. That’s why everything that sends data without their doing is off by default.

No cookies

No tracking, no stored IP address. Recognition only via a random key in the browser.

No input values

Form input, request and response bodies never leave the browser. Token-like values are scrubbed.

Redact and exclude

Password fields and areas with data-feedback-mask are blacked out, data-feedback-block isn’t recorded at all.

Your server

One binary, one SQLite file. No cloud, no third party, retention configurable per project.

Features per project

Replay, error tracking, test tasks, known issues: every feature has its switch – off means not even the code loads.

Signed identity

Your application can optionally sign user details – so nobody can pose as someone else.

Also

Small things that make every day easier.

Many projects

One instance for all your websites and apps, each with its own key and allowed origins.

REST API and tokens

Everything the dashboard does is available via API too – like uploading source maps in your build.

Five languages

Widget and dashboard in German, English, French, Italian and Spanish, light and dark.

Docker and Coolify

A ready package for Docker Compose and Coolify – or just start the binary.

Built-in handbook

The complete handbook lives in the app, with examples for nginx, Express, Go, Vite and Next.js.

Multiple accounts

The whole team works in the same dashboard, tickets can be assigned.

Download

Get it, start it, embed it.

IllusionFeedback is free to use – no account, no installer.

Start

Unpack the archive and start the binary – it creates its database and folders itself.

Set up

Open it in your browser, create the first account with the setup code from the log, add a project.

Embed

Paste the embed code into your website – done. The button appears right away.

Part of the IllusionForge family.

Lean, self-hosted tools with a shared design system: CMS, forms, data and feedback.