Getting Started

Add Reev to any website with one script tag. No npm install, no build step.

1. Create a project

2. Add the script tag

Paste this before </body> on every page:

<script>
!function(c,s){
  window.ReevConfig=c;
  s=document.createElement("script");
  s.src="https://your-domain.com/reev.js";
  document.head.appendChild(s)
}({
  projectId: "your-project-id",
  apiUrl: "https://your-domain.com"
});
</script>

Replace your-domain.com with where you host Reev and your-project-id with your actual project ID.

3. That's it

Reev starts detecting frustration immediately. No further configuration required. It will:

•Detect rage clicks on buttons and links
•Scan for broken links and dead images
•Watch for form frustration patterns
•Show a contextual popover asking users what went wrong
•Send reports to your dashboard with full context

Framework examples

Next.js (App Router)

// app/layout.tsx
import Script from "next/script";

export default function RootLayout({ children }) {
  return (
    <html>
      <body>
        {children}
        <Script
          id="reev"
          strategy="lazyOnload"
          dangerouslySetInnerHTML={{
            __html: `!function(c,s){window.ReevConfig=c;
              s=document.createElement("script");
              s.src="/reev.js";
              document.head.appendChild(s)
            }({projectId:"YOUR_ID",apiUrl:location.origin})`
          }}
        />
      </body>
    </html>
  );
}

Plain HTML

<!-- Before </body> -->
<script>
!function(c,s){
  window.ReevConfig=c;
  s=document.createElement("script");
  s.src="https://your-domain.com/reev.js";
  document.head.appendChild(s)
}({
  projectId: "YOUR_ID",
  apiUrl: "https://your-domain.com"
});
</script>

React (Vite / CRA)

// Add to index.html before </body>
<script>
!function(c,s){
  window.ReevConfig=c;
  s=document.createElement("script");
  s.src="https://your-domain.com/reev.js";
  document.head.appendChild(s)
}({
  projectId: "YOUR_ID",
  apiUrl: "https://your-domain.com"
});
</script>

Self-hosting

Reev is fully self-hosted. Your data stays on your server. You need:

•Node.js 18+
•PostgreSQL database
•Environment variables (see .env.example)

git clone https://github.com/your-org/reev.git
cd reev
pnpm install
cp .env.example .env   # fill in your DB credentials
pnpm db:migrate
pnpm build
pnpm start