Skip to main content

Performance

What makes moon-spa fast​

Server-side rendering (SSR)​

Every page load delivers pre-rendered HTML. The browser paints content immediately — no blank screen while JavaScript loads.

Selective DOM diffing​

The runtime only patches nodes that actually changed. Large parts of the DOM are untouched on state updates.

No virtual DOM allocation​

moon-spa's differ works directly on real DOM nodes using document.createTreeWalker. There is no intermediate VDOM object tree to allocate and garbage-collect.

Inline CSS​

Stylesheets are inlined at load time by the ComponentLoader. The browser never makes separate CSS requests.

Single JS bundle​

The entire runtime is embedded in the page as a <script> block — one HTTP request for HTML, zero additional JS requests.

Hot reload overhead​

With --reload, the server polls all watched files every 500ms. Components are re-loaded from disk and the view is rebuilt. This only affects development.

Tips​

GoalApproach
Reduce initial propsOnly pass what the entry component needs
Avoid unnecessary re-rendersDon't use updated lifecycle for side effects that don't need every update
Large listsUse key attributes to help the differ reuse nodes
Static contentPut non-interactive content outside the mounted #app div in index.lspa