Reloop

Self-hostable feedback SDK and dashboard.

packages/core      @reloop-sdk/core     framework-agnostic client
packages/react     @reloop-sdk/react    <ReloopProvider>, useFeedback(), <FeedbackWidget>
packages/vue       @reloop-sdk/vue      ReloopPlugin, useReloop(), <FeedbackWidget>
packages/vanilla   @reloop-sdk/vanilla  script-tag embeddable widget (auto-init)
apps/server        Express + better-sqlite3 + single-admin auth + ingest API
apps/dashboard     React + Vite admin UI (login, projects, API keys, feedback)
apps/docs          Docusaurus SDK documentation site
examples/react-demo  Vite app exercising @reloop-sdk/react end-to-end

Develop

pnpm install
pnpm build                       # builds SDK packages first (turbo topo order)

cp apps/server/.env.example apps/server/.env   # then set SESSION_SECRET + ADMIN_PASSWORD
pnpm --filter @reloop-sdk/server dev # http://localhost:8787
pnpm --filter @reloop-sdk/dashboard dev  # http://localhost:5173 (proxies /api)
pnpm --filter @reloop-sdk/docs dev   # http://localhost:3000 (SDK documentation)
pnpm --filter @reloop-sdk/example-react-demo dev

The dashboard links to the docs site via VITE_DOCS_URL (defaults to http://localhost:3000); set it for production deploys.

The server creates its SQLite tables on boot. There is a single admin account, configured via ADMIN_EMAIL / ADMIN_PASSWORD; there is no public sign-up.

Self-host

cp .env.example .env
# edit .env: set SESSION_SECRET (openssl rand -base64 32), ADMIN_PASSWORD,
# and DASHBOARD_ORIGINS=https://feedback.example.com
docker compose up -d --build

One container serves both the dashboard and the API on port 8787; SQLite is persisted in the reloop-data volume.

Using the SDK

1. Sign in to the dashboard, create a project.
2. Open the project → API Keys → Create key. The raw key (rl_pub_…) is shown once with a copy button and a ready-to-paste snippet. Only a SHA-256 hash is stored server-side.
3. Wire it up:

import { createClient } from "@reloop-sdk/core";

const reloop = createClient({
  apiKey: "rl_pub_...",
  endpoint: "https://feedback.example.com", // base URL; SDK appends /api/ingest
  user: { id: "user_123", email: "marty@example.com" }, // optional
});
reloop.submit({ type: "bug", message: "The export button 404s" });

React:

import { ReloopProvider, FeedbackWidget } from "@reloop-sdk/react";

<ReloopProvider apiKey="rl_pub_..." endpoint="https://feedback.example.com">
  <App />
  <FeedbackWidget />
</ReloopProvider>;

Plain HTML:

<script
  src="https://feedback.example.com/embed/reloop.global.js"
  data-reloop-key="rl_pub_..."
  data-reloop-endpoint="https://feedback.example.com"
></script>