feedly-widget

Visual feedback annotation widget. Drop into any web app and let testers annotate live.

Install

npm install feedly-widget

Use

import Feedly from 'feedly-widget'

Feedly.init({ projectId: 'YOUR_PROJECT_ID' })

That's it. The widget renders nothing until an admin enables the session for your project from the Feedly dashboard. When enabled, a small floating "F" button appears at the bottom right. Click it → name → annotate.

Custom Supabase endpoint

The widget is preconfigured with the Feedly hosted Supabase endpoint at build time. To point it at your own:

Feedly.init({
  projectId: 'YOUR_PROJECT_ID',
  supabaseUrl: 'https://YOUR-PROJECT.supabase.co',
  supabaseAnonKey: 'YOUR-ANON-KEY',
})

Tear down

Feedly.destroy()

How it works

• Mounts a Shadow DOM root on document.body so its CSS can't bleed into your app and vice versa.
• Subscribes to Supabase Realtime — the widget appears/disappears instantly when the admin toggles the session, no polling.
• Annotations are stored against the full window.location.href so they restore correctly when the tester revisits the page.
• Testers are identified by a device_id UUID in localStorage; no signup, no auth.