Getting started

This section gets you from zero to a running next.dj project. Read the overview to learn the mental model, then install the package. The six tutorial parts build a small Notes application from there.

Read first

Overview

The mental model behind next.dj. Read it once to understand pages, layouts, components, and actions.

Installation

Install the package, register it in Django, and serve a single page.

Build the Notes app

Building the first page

Create the Notes application, model the data, and serve the index page.

Adding layouts and context

Wrap pages in a layout and share data through context.

Components and static assets

Extract a component and ship co-located CSS and JS.

Forms and actions

Render forms and dispatch actions to create, edit, and delete notes.

Testing and autoreload

Test pages end to end and use the development server.

Live updates with partial rendering

Make the index live with zones and partial rendering, with a no-JavaScript fallback.

What to read next

Where to go for deeper topics, recipes, and reference material.