Contents

Introduction
- Introduction
Core Concepts
- Core Concepts
Quickstart (Composable Routing)
- Quickstart (Composable Routing)
Resource Lifecycle & State
- Resource Lifecycle & State
- Nested resources
Schema-Driven Message Dispatch
- Schema-Driven Message Dispatch
Hooks
- Hooks
Dependency Injection (How-to)
- Dependency Injection (How-to)
- Test-friendly factories
State Management (How-to)
- State Management (How-to)
Custom Connection Manager Backends (How-to)
- Custom Connection Manager Backends (How-to)
Background Workers
- Background Workers
Testing Toolkit
- Testing Toolkit
Reference Example
- Reference Example

Core Concepts

Updated Dec 08, 2025

WebSocketRouter – Mountable Falcon resource that owns route definitions and orchestrates instantiation.
WebSocketResource – Per-connection handler exposing lifecycle hooks (on_connect, on_disconnect) and message handlers.
Composable hierarchy – Resources can register child routes with add_subroute, passing context and shared state down the chain.
Schema-driven dispatch – Define a msgspec tagged union schema and register handlers with @handles_message("tag") (preferred) or on_tag method names.
Connection manager – WebSocketConnectionManager tracks active sockets, rooms, and supports pluggable backends.
Workers – ASGI lifespan-friendly background tasks coordinated by WorkerController.