API / Reference
Every decorator, every lifecycle hook, every template tag — what it does, when it fires, what it returns.
Twelve reference pages covering the public API surface. The hot ones are the decorators — @event_handler, @action, @server_function, @notify_on_save — but the lifecycle, template, and security pages are where the load-bearing details live when you need them.
The handler-shape primitives — what fires when, what state you can mutate, how to wire optimistic / rate-limited / permission-checked variants.
@event_handler, @action, @optimistic, @rate_limit, @server_function.
Every decorator with its kwargs, what it does at handler entry / exit, and how it composes with the others. Includes the v0.8.0 @action auto-state convention.
mount, get_context, on_disconnect, on_reconnect.
Where each method fires in the WebSocket → handler → VDOM diff path, plus the HTTP-fallback variants. The page also covers @on_mount and the v0.6.0 sticky-view lifecycle hooks.
Read the guide →dj-click, dj-input, dj-submit, dj-debounce.
Every reactive attribute, the JSON event shape, and the convention for accepting / typing handler parameters.
Read the guide →Template tags, the JIT-compiled Rust template engine, and the state primitives that make computed / derived values ergonomic.
live_render, dj_activity, dj-* attributes.
Every template tag and the Rust template backend's behavior contract. Covers the v0.9.0 lazy-render + parallel-chunk render path that live_render lazy=True ships.
Rust-powered context serialization, 10-100×.
Store querysets in self._private; assign self.public = self._private inside get_context_data(). The Rust serializer auto-detects the field accesses your template makes and emits exactly that data — no manual dict-building.
dj-loading.* attributes, suspense boundaries.
How the loading-state machinery works at the template level — pending markers, skeleton shimmer, suspense boundaries, and the dj-form-pending ancestor relationship.
The boring-but-critical reference pages — input handling, the security model, and the testing harness.
FormMixin, validate_field, formset helpers.
Per-keystroke validation, formset orchestration, {% inputs_for %}, and the data-dj-inline radio variant.
CSRF, CSP-strict, permission decorators.
The threat model the framework defends against, the v0.9.0 CSP-strict canonicalization, and the @permission_required contract.
LiveViewTestClient — fast, deterministic, no Selenium.
Mount a view, fire events, assert state — the same code path as the WebSocket consumer minus the transport. assert_push_event, assert_state, and the testing reference.
All twelve API reference pages — the canonical list of decorators, lifecycle, events, templates, forms, security, JIT, loading states, plus the LiveView and components references.