+2
日增长
+15
周增长
+52
月增长
7,716
stars
342
forks
8
watchers
504
prs
124
issues
25
releases
README
React Grab
Copy any UI element for your agent.
React Grab points agents to the actual source behind each selection. Agents are 2× faster and more accurate when using React Grab.
Website →
Quick Start
Run this at your project root:
bash
npx grab@latest init
How It Works
React Grab turns a browser selection into source context your agent can use:
1. Hover any UI element in your app.
2. Press ⌘C or Ctrl+C.
3. Paste the copied context into your agent.
The copied context includes the selected element and its component stack with source locations:
txt
[Forgot your password? in LoginForm (at components/login-form.tsx:46:19)]
Manual Installation
If you cannot use the CLI, install React Grab manually for your framework:
Next.js (App router)
Add this inside your app/layout.tsx:
jsx
import Script from "next/script";
export default function RootLayout({ children }) {
return (
{process.env.NODE_ENV === "development" && (
)}
{children}
);
}
Next.js (Pages router)
Add this into your pages/_document.tsx:
jsx
import { Html, Head, Main, NextScript } from "next/document";
export default function Document() {
return (
{process.env.NODE_ENV === "development" && (
)}
);
}
Vite
Add this at the top of your main entry file (e.g., src/main.tsx):
tsx
if (import.meta.env.DEV) {
import("react-grab");
}
Webpack
First, install React Grab:
bash
npm install react-grab
Then add this at the top of your main entry file (e.g., src/index.tsx or src/main.tsx):
tsx
if (process.env.NODE_ENV === "development") {
import("react-grab");
}
Build your own React Grab
Build a custom interface with the selection engine from react-grab/primitives. Use its APIs for hit testing, source context, page freezing, clipboard access, and editor navigation.
Customize hit testing
Scope hit testing to a container or replace the default element filter with your own rules.
typescript
import { getElementAtPoint, isElementGrabbable } from "react-grab/primitives";
export const getPickerTarget = (
event: PointerEvent,
appElement: Element,
toolbarElement: Element,
): Element | null =
getElementAtPoint(event.clientX, event.clientY, {
container: appElement,
filter: (candidate) = isElementGrabbable(candidate) && !toolbarElement.contains(candidate),
});
Add data-react-grab-ignore to your picker interface so hit testing skips its subtree.
Resources & Contributing Back
Want to try it out? Check out our demo.
Looking to contribute back? Check out the Contributing Guide.
Want to talk to the community? Hop in our Discord and share your ideas and what you've built with React Grab.
Find a bug? Head over to our issue tracker and we'll do our best to help. We love pull requests, too!
We expect all contributors to abide by the terms of our Code of Conduct.
Start contributing on GitHub
License
ReaTop issues
#358Overly generic results and missing information in context4 comments · 2026-05-18#417Prefer React fiber _debugSource when owner stack resolves to generated/virtual source3 comments · 2026-05-28#247bunx -y grab@latest init can't process install on nuxt project3 comments · 2026-03-16#239Open with Cursor (or any IDE) not working3 comments · 2026-03-13#231SvelteKit is not yet supported by automatic setup.3 comments · 2026-03-09#64Error: Failed to spawn Claude Code process: spawn claude ENOENT when using agent mode with Next.js3 comments · 2025-12-10#31React Native or expo support?3 comments · 2025-11-29#14NextJS + TypeScript - Installed & Grab animation showing but not copying anything. Next + Bootstrap working Fine - Pages Router3 comments · 2025-11-05
Latest release
@react-grab/[email protected] @react-grab/[email protected] 2026-08-16Minor Changes - f350003: Remove the Style action and panel, including its keyboard shortcuts, inline previews, CSS property controls, design-token handling, and edit-related action context and renderer types. Simplify the toolbar to its Copy control while keeping Comment available through the context menu and action menu.