Django Grid View¶

django-grid-view is a reusable Django app for declarative data views in dashboards and chat UIs.

Install from PyPI:

pip install django-grid-view

Three ways to render data¶

Simple Table¶

Server-rendered lists with sort, search, and export.

Python: SimpleTableConfig
Template: {% render_simple_table %}

AG-Grid¶

Large datasets, infinite row model, saved searches.

Python: your view + GridPreference
Template: {% django_grid_view_scripts %}

Grid View 1.0¶

KPI strip, ECharts, and table from one spec.

Python: GridRenderer / build_artifact_from_view
Template: {% render_grid_view %}

Layer model: rows + GridViewSpec → GridArtifact

Core rule: numeric KPI and chart values always come from Python rows. Specs and LLM output describe structure only.

Quick links¶

Getting started — install, Django setup, first table
Grid View artifacts — GridViewSpec → GridArtifact
Changelog — release notes
LLM context bundle — single file for agents (about the bundle)
GridViewSpec reference — JSON Schema contract
Python types — imports for host apps (pyright/mypy)

Publishing this documentation¶

The docs site is built with MkDocs Material and deployed to GitHub Pages via the Docs workflow. Repository maintainers: enable Settings → Pages → Build and deployment → GitHub Actions, then set the repository Website to https://alpiua.github.io/django-grid-view/.