Ozvi

Ozvi

Source-available bug reports and an idea board that look like your product.

Website · Live demo · Docs · Videos · @ozvi/widget · @ozvi/sdk

• Two spaces. A private bug flow with automatic context (page, app version, browser, console errors, a screenshot with form values, e-mails, phone numbers and card numbers covered in the browser) and a public idea board with voting, roadmap and changelog.
• Closing the loop. "Fixed in 2.15.1 — does it work for you?" goes to the reporter, linked GitHub issues and releases set it for you, and publishing a changelog entry e-mails everyone who voted.
• Your design. One theme.json (colours, fonts, radius, density) styles the board, the widget and the e-mails.
• Your login. Users stay signed in from your app via a signed token or OIDC; boards can also offer sign-in by e-mailed code.
• Your tools. A built-in MCP server (personal tokens or OAuth connectors) lets Claude and other agents search, summarise, triage and publish — with confirmation for anything irreversible and user text always handed over as data. Webhooks for Slack, Discord or your backend.
• Optional AI. Duplicate detection (embeddings via any OpenAI-compatible endpoint, or fuzzy text matching with none), thread summaries, changelog drafts and a weekly team digest written by the model you choose: Claude natively or any OpenAI-compatible API (OpenAI, Mistral, Ollama, vLLM…).

Self-hosting is free with every feature (FSL-1.1-ALv2, see Licence). The same image runs the hosted cloud.

Embed in your app

<script src="https://feedback.example.com/widget.js" defer></script>
<ozvi-widget project="myapp" token-url="/api/ozvi-token" app-version="1.4.0"></ozvi-widget>

// npm i @ozvi/sdk   (MIT, zero deps; Python and PHP without a library: ozvi.io/docs/widget#sign-in)
import { signOzviToken } from "@ozvi/sdk";
app.get("/api/ozvi-token", requireLogin, (req, res) =>
  res.json({ token: signOzviToken({ id: req.user.id, email: req.user.email, name: req.user.name }, process.env.OZVI_SSO_SECRET) }));

Screenshots cover form values, e-mails, phone numbers, IBANs, card numbers and tokens on their own; mark anything else sensitive (names, notes) with data-ozvi-mask, or set OzviConfig.mask = "all" to cover all text. More: docs/INTEGRACIA.md.

Self-host

cd deploy && cp .env.example .env && docker compose up -d
docker compose exec ozvi node ozvi.mjs project:create myapp "My app" --origin https://app.example.com

Images are public on ghcr.io/xzamiska/ozvi (amd64 and arm64; tags such as 1.2.8, 1.2, 1, latest). An optional updater container backs up the database, installs a new version on request or at night and rolls back when it is not healthy. Release notes: ozvi.io/releases.

See docs/SELFHOST.md. Moving from Fider: docs/MIGRACIA-Z-FIDERU.md. Cloud mode: docs/CLOUD.md. Decisions: docs/adr.

Optional: OZVI_AI_PROVIDER (anthropic or openai for any OpenAI-compatible API) + OZVI_AI_API_KEY + OZVI_AI_MODEL turn on AI writing help (see docs/SELFHOST.md); OZVI_EMBEDDINGS_URL + OZVI_EMBEDDINGS_MODEL turn on embedding-based duplicates.

Connect an AI assistant

claude mcp add --transport http ozvi https://feedback.example.com/mcp --header "Authorization: Bearer ozvi_pat_…"

Or add https://feedback.example.com/<project>/mcp as a custom connector in Claude — sign-in and consent happen on the board. Tools: packages/mcp/README.md.

Develop

pnpm install
cp .env.example .env
pnpm dev            # Postgres 17 + Mailpit in Docker, migrations, web on :3300
pnpm test

With pnpm dev and OZVI_DEV_LOGIN=1 (in .env.example): http://localhost:3300/dev/login?project=billiwo&as=team signs you in as an admin, http://localhost:3300/demo shows the widget inside a fake host app, Mailpit is on http://localhost:8046.

Path	What
apps/web	Next.js board, roadmap, changelog, admin, /app (cloud), widget API, MCP, workers, Fider importer
packages/db	Drizzle schema and migrations (Postgres 17)
packages/theme	theme.json schema, presets, CSS variables, contrast checks
packages/sdk	signOzviToken for host-app SSO (MIT)
packages/widget	Embeddable <ozvi-widget> (Preact, shadow DOM, ~10 kB gzip)
packages/mcp	MCP tools served at /mcp

Licence

FSL-1.1-ALv2 (Functional Source License, Apache 2.0 future licence): use, modify and self-host Ozvi for any purpose except offering it as a competing commercial service. Each release becomes Apache 2.0 two years after it is published.

packages/sdk and packages/widget are MIT so they can ship inside closed-source host apps.