Guides
One guide per area.
Short, accurate tours of each part of the framework — the ideas, the main APIs and the rules — with links to every package’s AGENTS.md for the full surface.
Core & dependency injection
Tokens, units, the readiness-aware injector, dependency kinds, scopes, variants and compile-time completeness.
coreLifecycles & the runtime
App supervisor, subsystems with restart policies, features with independent logic/UI lifetimes, retention, the frame scheduler, worker scheduling and memory ledgers.
runtimeRouting & URL state
The 13-stage navigation pipeline, typed routes, exit guards, view sub-routes, routable dialogs, URL bindings and consume-once intents.
routerurlstatehandoffAuth, gating & credits
Identity providers and the session machine, facts → policies → decision tables, agents as subjects, meters with reserve → commit.
authgateconfigData & storage
Transports, endpoints and resources with SWR, the single retry layer, schema-first stores with patches, user-data slices, and one async storage interface.
datastorageWorkers, documents, Wasm & surfaces
Supervised workers and typed protocols, read-only replicas, the CRDT document engine, Wasm modules as units, render workers and rich surfaces.
workerdocumentwasmsurfaceEditors: pipeline, documents, stage, blobs & raster
The editor ↔ render pipeline, document v2 with one CRDT doc per page, the composed stage and per-actor undo, a content-addressed blob store, GPU raster, text input and images.
workerdocumentstageblobsurfacePerformance, observability & devtools
One telemetry fabric, journey traces, framework-measured feature marks, budgets, the conformance stream, the loader’s warmup tiers and the devtools panel.
perfloaderdevtoolscoreUI, shell, messaging, a11y & i18n
Lit components with declared deps, fine-grained rendering, the theme contract and kit, the shell frame and layout specs, one surface manager, focus and announcements, typed ICU catalogs.
uikitshellmessaginga11yi18nPWA & hydration
Service worker from warmup tiers, safe updates without reload, launch intents; islands over prerendered HTML and store snapshots for instant boot.
pwahydrateAI, capabilities, WebMCP, advisors & sandbox
Typed capabilities with one gated pipeline for UI, palette and agents; WebMCP publishing; one model-provider port; advisors that only tune performance; sandboxed plugins.
capabilitieswebmcpaiadvisorssandboxBuild tooling: Vite, Rspack & the sf CLI
Logical chunks to bundler chunks, sf-manifest.json, per-profile preloads, budgets, Module Federation 2.0, and the CLI that enforces the rules.
vite-pluginrspack-pluginsfloaderTesting with @staticflux/testkit
Test injector with overrides and recorded telemetry, deterministic fake time, fake sessions, bootTestApp, shared contract suites.
testkit