Scaffolding Generator

Generate a complete CRUD LiveView from a model name and field definitions.

Quick Start

python manage.py djust_gen_live blog Post title:string body:text published:boolean

This creates:

File	Description
`blog/views.py`	`PostListView` with mount, search, show, create, update, delete handlers
`blog/urls.py`	URL routing using `live_session()`
`blog/templates/blog/post_list.html`	List + detail panel with `dj-*` directives
`blog/tests.py`	Basic test scaffold

Usage

python manage.py djust_gen_live <app_name> <ModelName> [field:type ...] [options]

Arguments

Argument	Description
`app_name`	Django app name (directory must exist)
`model_name`	PascalCase model name (e.g. `Post`, `BlogPost`)
`fields`	Field definitions as `name:type` pairs

Options

Option	Description
`--dry-run`	Preview files without writing
`--force`	Overwrite existing files
`--no-tests`	Skip generating test file
`--api`	Generate JSON API (`render_json`) instead of HTML

Supported Field Types

Type	Django Model Field	Form Input
`string`	`CharField`	`<input type="text">`
`text`	`TextField`	`<textarea>`
`integer`	`IntegerField`	`<input type="number">`
`float`	`FloatField`	`<input type="number" step="any">`
`decimal`	`DecimalField`	`<input type="number" step="0.01">`
`boolean`	`BooleanField`	`<input type="checkbox">`
`date`	`DateField`	`<input type="date">`
`datetime`	`DateTimeField`	`<input type="datetime-local">`
`email`	`EmailField`	`<input type="email">`
`url`	`URLField`	`<input type="url">`
`slug`	`SlugField`	`<input type="text">`
`fk:Model`	`ForeignKey`	`<input type="number">` (ID)

Examples

Basic CRUD

python manage.py djust_gen_live blog Post title:string body:text

With Foreign Key

python manage.py djust_gen_live blog Post title:string body:text author:fk:User

Preview Without Writing

python manage.py djust_gen_live blog Post title:string --dry-run

JSON API Mode

python manage.py djust_gen_live blog Post title:string body:text --api

Overwrite Existing

python manage.py djust_gen_live blog Post title:string --force

Generated Code Patterns

Views

The generated view uses standard djust patterns:

mount() initializes state
_compute() re-queries the database
@event_handler() decorates all event handlers
Search uses Q objects for OR logic across text fields
CRUD operations: create, show, update, delete

URLs

Routes use live_session() for proper WebSocket support:

from djust.routing import live_session

urlpatterns = [
    *live_session("/blog", [
        path("post/", PostListView.as_view(), name="post_list"),
    ]),
]

Templates

Generated templates use djust directives:

dj-root / dj-view for LiveView binding
dj-input for real-time search
dj-click / dj-submit for event handlers
dj-value-* for passing parameters
dj-confirm for delete confirmation
dj-loading for loading states

After Generation

Add your app to INSTALLED_APPS
Add 'yourapp.views' to LIVEVIEW_ALLOWED_MODULES
Include yourapp.urls in your root URL conf
Create the model in yourapp/models.py
Run python manage.py makemigrations && python manage.py migrate