How preactjs/preact works
Preact is a compact Virtual DOM UI library. The principal workflow is that application code describes component trees (often via JSX), calls render or hydrate, and Preact reconciles those descriptions into DOM updates. Components and hooks manage state and context; optional packages provide React compatibility, server rendering, debugging, DevTools, and JSX runtime support. Several extension implementations were not sampled, so their documented capabilities are shown without speculative internal call paths.
Main entry points: diff/index.js VNode diff · src/index.js Public API · src/index.js React compatibility · component.js Components and updates
Components 19
Core rendering
- VNode creation
src/create-element.js - Public API
src/index.js - Render and hydrate
src/render.js - VNode diff
src/diff/index.js - Child reconciliation
src/diff/children.js - DOM properties
src/diff/props.js
Components and state
- Components and updates
src/component.js - Context providers
src/create-context.js - Hooks
hooks/src/index.js
Compatibility and tooling
- React compatibility
compat/src/index.js - Compat rendering
compat/src/render.js - Suspense and lazy
compat/src/suspense.js - Runtime diagnostics
debug/src/debug.js - DevTools integration
devtools/src/devtools.js
JSX and server
- JSX runtime
jsx-runtime/src/index.js - Server rendering
compat/server.js - Async scheduler
compat/scheduler.js
Other components
- Application code
- Browser DOM
Connections 21
- Application code → VNode creation: describes UI
- Application code → Public API: calls render
- Public API → VNode creation: exports creation
src/index.js - Public API → Render and hydrate: exports rendering
src/index.js - Render and hydrate → VNode diff: reconciles tree
src/render.js - VNode diff → Child reconciliation: diffs children
src/diff/index.js - VNode diff → DOM properties: sets properties
src/diff/index.js - Render and hydrate → Browser DOM: updates DOM
- VNode diff → Browser DOM: patches DOM
src/diff/index.js - Components and updates → VNode diff: rerenders components
src/component.js - Context providers → Components and updates: queues updates
src/create-context.js - Hooks → Application code: provides hooks
- React compatibility → Components and updates: adapts components
compat/src/index.js - React compatibility → Hooks: re-exports hooks
compat/src/index.js - React compatibility → Compat rendering: exports rendering
compat/src/index.js - React compatibility → Suspense and lazy: exports Suspense
compat/src/index.js - Runtime diagnostics → Public API: hooks renderer
debug/src/debug.js - DevTools integration → Public API: integrates DevTools
- Application code → JSX runtime: uses JSX
- Application code → Server rendering: renders server-side
- Components and updates → Async scheduler: schedules updates