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, formsets, dispatch internals, signals.
Static Assets: Co-located files, deduplication, asset kinds, backends, JS context.

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.