preact-react-reconciler turns Preact into a drop-in React reconciler

What it is

A little GitHub project called preact-react-reconciler aims to do something neat: let unmodified code that imports the real react package run under Preact. Who needs a bundler alias? The library hooks into Preact's option hooks and implements enough of React's reconciler API to make common React code — hooks, functional components, the whole nine yards — work as if it were running on React. It has been reported that you can even use it alongside react-dom on the same page, with the same copy of react, at the same time.

How it works (in plain terms)

Under the hood, the package wires Preact’s lifecycle and hook mechanisms to behave like React’s reconciler. The project’s README shows a familiar example: a Counter component that uses useState and useCallback, rendered once with preact.render and once with react-dom.createRoot — same component, same react import. Pretty neat. But is it magic? Not exactly. It’s clever engineering that patches compatibility gaps rather than rewrites either framework.

Why it matters

For teams tired of alias hacks or juggling two component builds during migration, this could shave off friction. Smaller bundles, easier progressive migration, or running micro-frontends that differ in their rendering choices — those are real, tangible wins. That said, compatibility isn’t free: edge cases exist. It has been reported that some React-specific internals may not be perfectly replicated; compatibility is substantial but allegedly not absolute. So test your app before declaring victory.

What to watch

This is the kind of developer convenience that spreads fast if it holds up under real-world apps. Check the repository for issues, test with your tooling, and keep an eye on benchmarks — especially if bundle size or SSR behavior matters. Try it, file bugs, and enjoy the rare moment when the dev tooling gets a little bit less annoying.

Sources: github.com/easrng, Lobsters