Widget installieren

Das Cirlo-Widget ist ein einzelnes Script-Tag. Es rendert einen Feedback-Button unten in deiner App, kapselt sein Styling im Shadow DOM und meldet sich beim ersten Laden automatisch.

Einbauen

Vor dem schliessenden </body> einfügen:

<script src="https://cirlo.dev/widget.js" data-key="DEIN_WIDGET_KEY" data-accent="#4f46e5" data-position="bottom-right" data-lang="de" defer></script>

• data-key (Pflicht): dein Projekt-Key, beginnt mit w_.
• data-accent (optional): Akzentfarbe deiner App als Hex-Wert.
• data-position (optional): bottom-right oder bottom-left.
• data-lang (optional): de oder en.
• data-repro (optional): off schaltet die Browser-Erfassung komplett ab.

Was das Widget erfasst

Bei einem Bug-Report (nie bei Idee oder Lob) schickt das Widget ein Repro-Paket mit: die letzten 40 Ereignisse vor der Meldung, ausschliesslich im Arbeitsspeicher gehalten.

• Klicks: Beschreibung des Elements (Tag, id oder erste Klasse, sichtbarer Text). Bei Formularfeldern nur der Feldname, nie der eingegebene Wert.
• Navigation: nur der Pfad, ohne Query-String.
• JS-Fehler: Meldung und Fundstelle (console.error, unbehandelte Fehler, abgelehnte Promises).
• Fehlgeschlagene Requests: Methode, URL ohne Query-String, Statuscode, Dauer. Nur ab Status 400 oder bei Netzwerkfehlern.

Nie erfasst: Tastatureingaben, Feldinhalte, Inhalte von Requests oder Antworten, Header, Cookies, Screenshots, Video. Secret-verdächtige Zeichenketten werden serverseitig entfernt, das Paket ist auf 8 KB begrenzt. In den Projekt-Einstellungen abschaltbar.

Eingeloggten Nutzer erkennen (optional)

window.cirlo.identify({ email: "user@example.com", name: "Alex" });

Maschinenlesbare Kurzfassung: https://cirlo.dev/llms.txt