Philosophy
Concepts
The thesis the rest of this handbook proves: page, slots, deferred regions, live refresh and interactive components all stay inside one server-owned rendering story — no second frontend, no presentation-boundary leaks. Start here; everything else is an application of these principles.
Concepts
One continuous rendering architecture
Not SSR for the first paint and a second frontend for the rest: page, slots, deferred regions, live refresh and interactive components share one server story.
Concepts
Page Contract
The page response is a typed Resource DTO before Twig sees a single field, so the template renders a prepared object instead of discovering data.
Concepts
Presentation Boundary
Templates are presentation surfaces, not data loaders. A template that reaches into storage is a structural failure, not a style preference.
Concepts
Region Contract
A region is a resource with a pipeline, not a partial with lucky context. Each region has its own handler flow, render context and asset collection.
Concepts
Late HTML
Deferred blocks stream server-rendered HTML later instead of handing control to a client renderer. The shell paints at once; slow regions arrive over SSE.
Concepts
Live HTML
Reactive slots refresh from server truth without a second state machine. Set a cadence, the server re-renders the region and the page swaps the HTML in place.
Concepts
Interactive HTML
Components dispatch backend events without leaving the SSR component model. A component declares its event contract; the server signs it and runs the handler.
Concepts
Framework-Free JS
JavaScript may enhance the page, but Semitexa never requires React, Alpine or Angular as a second rendering layer. Script stays small and component-owned.