Topic guides#

Topic guides cover one subsystem at a time. Read the topic that matches the part you are touching, then jump to the reference for the exact API.

Routing

File router

File based routing, captured parameters, page roots, hot reload.

URL reversing

page_reverse and with_query helpers.

Pages, layouts, and components

Pages

Page modules, body sources, render functions, template loaders.

Layouts

Layout discovery, composition, layout level context.

Context

@context and @component.context patterns and inheritance.

Components

Simple and composite components, props, slots, co-located assets.

Forms and static assets

Forms

Actions, templates, modelforms, field components, formsets, multi-step wizards, dispatch internals, signals.

Static assets

Co-located files, deduplication, asset kinds, backends, JS context.

Partial rendering

Zones, patches, forms, the modal wizard, lazy zones, co-located JavaScript, and the SSE bridge.

Cross-cutting concerns

Dependency injection

Markers, providers, the resolver, request scoped cache.

Signals

Every signal emitted by the framework, with payload tables.

Testing

NextClient, SignalRecorder, registry isolation.

Extending

Five extension mechanisms across the framework.

Project layout

Project layout

Recommended single project tree and settings.

Multi-project setup

Shared UI kit and per project page DIRS.