Ideal Postcodes
All updates

React Component for Address Finder

Add UK address autocomplete to a React app in a single component. The new @ideal-postcodes/react package gives you a drop-in <AddressFinder> with no useEffect or useRef wiring to manage. Install with npm install @ideal-postcodes/react.

Details

  • Drop-in component: Render <AddressFinder> and start searching. The widget lifecycle is handled for you, with no manual setup or teardown
  • Bring your own input: Let the component render its own field, or wrap an input you already have. It works alongside design systems such as shadcn/ui, MUI, and Mantine
  • Every callback as a prop: Each widget event is exposed directly, including onAddressRetrieved. Inline handlers always see your latest state, so there is no need to reach for useCallback
  • Styling that fits your build: CSS is injected automatically, or import it yourself for full control under server-side rendering
  • Framework ready: Tested with the Next.js App Router ("use client") and Pages Router, Remix, and Astro, on both React 18 and 19

Read the React integration guide to get started. The latest Address Finder (5.2.15) and Postcode Lookup (3.3.2) widget bundles also ship in this release.