Core concepts and usage recipes for the framework.

Where to start?

You are... Go read...
New to fw Quick start then Todo app tutorial
Looking for "how to do X" Index by use case — task-oriented docs
Writing a module Module pattern + Workflow
Debugging production code Security and Quick reference

Concepts

Guide Description
Quick start Import, resolver, complete hello-world
Todo app tutorial Todo in under 100 lines — signal + form + ui.list + persistence
Index by use case "I want X → API to use"
Module pattern The factory convention: structure, return shapes, rules
Web Workers createWorker, serialisation, RPC pattern
Rendering pipeline parser → render → template → uiSession
Security sanity/base.js: blocked APIs, redirections, frozen prototypes
Worker confinement lockdown + Worker capability grant, withholding ambient authority, limits
Gestures & DnD: side-channel Why these modules exit the reactive pipeline
Bundler integration Standalone vs bundler-integrated modes (Vite, Webpack, Rollup, esbuild)
Hot module replacement runtime.invalidate(), the dehydrate/hydrate convention, and what is not preserved
HMR per integration What each integration supports today, and what the host bundler provides instead
TypeScript Cohabiting .d.ts declarations, worker-serialisation pitfall, narrow typings

Contribution conventions

Guide Description
Test format *.test.js convention (bun) — skeleton, sections, naming. For running the suite (bun/Node), see ../dev/testing.md.
Documentation format docs/api/ page convention — frontmatter, sections, README cascade
Module creation workflow Step-by-step operational plan — discovery, implementation, tests, doc, cascade