Guides
Task-oriented recipes for building with Layers.
From your first open call through queues, nesting, animations, and SSR. Each guide is framework-agnostic where possible; parallel adapter syntax uses tabs.
Start here
- Getting started — declare a layer, mount an outlet, open and await
- Install — packages and peer dependencies
Core patterns
- Awaiting results —
await open, DataTag inference, fire-and-forget - Singletons —
upsert+updatefor toasts and progress - Serial queues —
scope: serial,getQueuedSnapshot - Nested overlays — layer groups, child stacks, inline outlets
Polish and safety
- Animations —
transition, delays,call.settle() - Dismissal blockers —
addBlocker,dismissing,dismissAllmodes - Payload validation — Standard Schema,
PayloadValidationError - Error handling — promise rejections,
Register, narrowing
Advanced
- Headless rendering —
useStackHandles,StackSubscribe, custom hosts - SSR — per-adapter server rendering posture
- Devtools — inspect stacks in TanStack Devtools;
subscribeNotify
For the engine model and terminology, see Concepts.