React IDX Plugin with CRM for React & Next.js Real Estate Websites

Install the official package and wrap your app once with the provider:

1. Run npm install @buyingbuddy/react.
2. Add <BuyingBuddyProvider activationKey="your-key"> near the top of your component tree.
3. Place <BuyingBuddyWidget type="SearchForm" /> and other widgets wherever you want MLS content.

The provider loads the Buying Buddy runtime for you, so there are no script tags to manage. The same package works across Vite, Create React App, Next.js, Gatsby and Remix.

Yes. Because the provider loads in the browser, it lives in a Client Component. In the App Router, create a small "use client" providers wrapper and use it in your root layout; in the Pages Router, wrap the app in pages/_app.tsx.

Pages that render widgets are interactive client components - add "use client" to the page, or keep the widget in a small client component imported into a server page so your data fetching stays on the server.

Yes. Widgets will not load without a valid Buying Buddy account and activation key - there is no anonymous mode. Find your key in your welcome email or in your dashboard under Widgets > Installation and Setup, and pass it to the provider as the activationKey prop.

Don't have an account yet? Start a 30-day free trial or buy a license.

Widgets only load on domains registered to your account. localhost is not currently supported, but you can use a sandbox, staging or development domain - just ask our Help Desk to add it as an authorized domain.

Four routes, each rendering a single widget:

• Results route (e.g. /listing-results) renders <BuyingBuddyWidget type="SearchResults" />
• Details route (e.g. /listing-details) renders <BuyingBuddyWidget type="SearchDetails" />
• Market Report route (e.g. /market-area-report) renders <BuyingBuddyWidget type="MarketReport" />
• Communities route (e.g. /featured-communities) renders <BuyingBuddyWidget type="Communities" />

Keep only that one widget in the main content of each (a footer Disclaimer and header login widgets are fine), confirm the paths match the Foundation Pages tab in your dashboard, and do not put a search form on these routes.

The widgets render in the browser after the runtime loads, so their content is not part of the initial server HTML. They are ideal for interactive MLS search, listing display and lead capture inside your React or Next.js site.

Your pages, routes and metadata stay under your control with your framework's own routing and head management, so you build SEO-friendly pages and add Buying Buddy widgets for the live MLS data and capture.

No. You don't need any API credentials, tokens or keys from the MLS, and there are no databases to add to your app. Buying Buddy receives the IDX feed directly from the MLS and the widgets display that content in your pages.

An IDX license agreement and approval from your MLS is required to show live data - a standard process we help you with. Until then, widgets display data from our Demonstration MLS, and switch to your live MLS automatically once approved.

The @buyingbuddy/react package requires React 18 or 19 as a peer dependency. A manual script-based fallback works on any modern React version, but the package is recommended for virtually every project.