Install

Self-serve path

Add Entrofeed to any app

Use this flow for Siftor, future Entroparc apps, and later public customer installs. The project page gives the real project key; this page keeps the repeatable contract clear.

Connect app npm package

Project

Connect app

Create a project boundary and bind the first host origin.

Widget

Install package

Add the npm widget and mount it once in the host app shell.

Signal

Submit smoke

Send one live feedback item from the installed host page.

Trust

Lock origin

Save the detected browser origin on the active project key.

Ready

Connected

Confirm the latest signal is key-bound and origin-verified.

Copyable baseline

React package install

replace pk_live_your_project_key

@entroparc/entrofeed-widget

v0.1.3

Key-bound

Public widget package and host-app install contract

Published package

latest v0.1.3

Canonical URL

https://www.entrofeed.com

Origin policy

Project key has explicit allowed origins

Runtime limits

30/IP/min · 12/project+IP/min · 240/project/hour · 16KB body

npm

Install package

npm install @entroparc/entrofeed-widget@latest
# or
pnpm add @entroparc/entrofeed-widget@latest

# Current Entrofeed widget version: 0.1.3

Host app env

NEXT_PUBLIC_ENTROFEED_URL=https://www.entrofeed.com
NEXT_PUBLIC_ENTROFEED_PROJECT_KEY=pk_live_your_project_key

React mount

"use client";

import { usePathname } from "next/navigation";
import { EntrofeedWidget } from "@entroparc/entrofeed-widget";

type ProductFeedbackProps = {
  user?: {
    id?: string;
    email?: string | null;
    username?: string | null;
  };
};

export function ProductFeedback({ user }: ProductFeedbackProps) {
  const pathname = usePathname();

  return (
    <EntrofeedWidget
      apiBaseUrl={process.env.NEXT_PUBLIC_ENTROFEED_URL!}
      projectKey={process.env.NEXT_PUBLIC_ENTROFEED_PROJECT_KEY!}
      user={{
        id: user?.id,
        label: user?.email ?? user?.username ?? undefined,
      }}
      context={{ path: pathname, route: pathname }}
    />
  );
}

Script tag

<script
  async
  src="https://www.entrofeed.com/widget.js"
  data-project-key="pk_live_your_project_key"
></script>

Agent prompt

Install Entrofeed feedback into this React/Next.js app.

Use the repo's package manager to add @entroparc/entrofeed-widget@latest.
Set these public env vars:

NEXT_PUBLIC_ENTROFEED_URL=https://www.entrofeed.com
NEXT_PUBLIC_ENTROFEED_PROJECT_KEY=pk_live_your_project_key

Mount EntrofeedWidget once in the authenticated app layout or product shell.
Pass the current pathname as both path and route, and pass the current user id/email when available.
Do not put server secrets in NEXT_PUBLIC vars.
Use the Entrofeed URL exactly as shown; browser CORS preflight requests cannot follow domain redirects.
Make sure the host origin is allowed in Entrofeed: https://your-app.example.
If this is not a React app, use the hosted script tag from the Entrofeed install page instead of adding the npm package.
Run lint/build after the change, then submit one live feedback smoke test and confirm it appears in Entrofeed.

Smoke test

1. Allowed origin: https://your-app.example
2. Start or deploy the host app with the two NEXT_PUBLIC_ENTROFEED_* vars.
3. Open the page where EntrofeedWidget is mounted.
4. Submit a short test message from the launcher.
5. Confirm the item appears in Entrofeed /inbox with the right project, path, and user label.
6. If the browser console shows a CORS preflight redirect, confirm NEXT_PUBLIC_ENTROFEED_URL is the canonical Entrofeed URL shown above.

Key-bound

https://your-app.example

Origin rules

Project keys own customer domains

Future app domains belong on the active project key, not in Entrofeed's service-wide Vercel allowlist.

Exact browser origins only

Scheme, hostname, and port must match. Apex and www origins are separate when both serve the app.

Redirects do not fix CORS

Use the canonical Entrofeed URL in host app env vars. Browser preflight requests cannot follow a redirected API base URL.

Agent install standard

Coding agents should add the package, mount the widget once, preserve host user/path context, run lint/build, then submit one live feedback smoke test.

Next install path

The hosted script tag is available at `/widget.js` for non-React apps and CMS pages. Use the React package when the host app has a typed React shell; use the script tag when install speed matters more than framework integration.

Project-specific snippets

Open a project to copy its real key, origins, smoke test, and agent prompt.

Widget preview

Check the capture surface and package contract before embedding it in another app.

Source and releases

Keep the app, package, and release process connected to the public repository.

"use client"; import { usePathname } from "next/navigation"; import { EntrofeedWidget } from "@entroparc/entrofeed-widget"; type ProductFeedbackProps = { user?: { id?: string; email?: string | null; username?: string | null; }; }; export function ProductFeedback({ user }: ProductFeedbackProps) { const pathname = usePathname(); return ( <EntrofeedWidget apiBaseUrl={process.env.NEXT_PUBLIC_ENTROFEED_URL!} projectKey={process.env.NEXT_PUBLIC_ENTROFEED_PROJECT_KEY!} user={{ id: user?.id, label: user?.email ?? user?.username ?? undefined, }} context={{ path: pathname, route: pathname }} /> ); }

Install Entrofeed feedback into this React/Next.js app. Use the repo's package manager to add @entroparc/entrofeed-widget@latest. Set these public env vars: NEXT_PUBLIC_ENTROFEED_URL=https://www.entrofeed.com NEXT_PUBLIC_ENTROFEED_PROJECT_KEY=pk_live_your_project_key Mount EntrofeedWidget once in the authenticated app layout or product shell. Pass the current pathname as both path and route, and pass the current user id/email when available. Do not put server secrets in NEXT_PUBLIC vars. Use the Entrofeed URL exactly as shown; browser CORS preflight requests cannot follow domain redirects. Make sure the host origin is allowed in Entrofeed: https://your-app.example. If this is not a React app, use the hosted script tag from the Entrofeed install page instead of adding the npm package. Run lint/build after the change, then submit one live feedback smoke test and confirm it appears in Entrofeed.

1. Allowed origin: https://your-app.example 2. Start or deploy the host app with the two NEXT_PUBLIC_ENTROFEED_* vars. 3. Open the page where EntrofeedWidget is mounted. 4. Submit a short test message from the launcher. 5. Confirm the item appears in Entrofeed /inbox with the right project, path, and user label. 6. If the browser console shows a CORS preflight redirect, confirm NEXT_PUBLIC_ENTROFEED_URL is the canonical Entrofeed URL shown above.