django-mvp

Guide for creating demo views in the django-mvp Demo App. Use when adding new demo pages to showcase components, layouts, or features — covers view creation, template structure, URL wiring, and sidebar menu registration. Emphasizes single configurable view classes with .as_view() attribute overrides instead of duplicating views.

Step-by-step guide for integrating django-mvp into a Django project. Use when wiring up the AdminLTE 4 layout shell: INSTALLED_APPS setup, EASY_ICONS Bootstrap Icons config, FLEX_MENUS adminlte renderer, base template using Cotton component attributes, sidebar menu via AppMenu, dual-mode views, and error pages. Covers common pitfalls: wrong icon renderer, missing adminlte renderer registration.

Guide for building the sidebar navigation menu in django-mvp by adding items to the AppMenu. Use when creating, modifying, or extending the sidebar menu — adding links, collapsible groups, section headers, badges, icons, or conditional visibility checks. Covers MenuItem, MenuGroup, MenuCollapse, the AppMenu global, and extra_context options.

Guide AI agents on testing Django Cotton components using django-cotton-bs5 pytest fixtures. Covers when to use cotton_render vs cotton_render_soup vs cotton_render_string vs cotton_render_string_soup, best practices for component testing, DOM assertions, context handling, and multi-component testing patterns. Use when writing or reviewing Cotton component tests.

Expert guide for working with Django Cotton, a component-based UI composition library. Use when creating, modifying, or testing Cotton components — covers component syntax, slots (default and named), attributes, c-vars, dynamic attributes with Python types, attribute proxying, template organization, naming conventions, and integration patterns. Essential for building reusable UI components in Django templates.

Write, review, and maintain tests for Django projects using pytest. Use when asked to create new tests, add test coverage for a module, review existing tests, fix failing tests, or refactor test code. Covers pytest conventions, factory-boy usage, fixture design, test structure (flat mirror of source tree), Django model/form/view/admin testing patterns, and performance guard patterns using query-count assertions. Also use when discussing testing strategy, test organization, or when creating new modules that need accompanying tests.

Automate browser interactions, test web pages and work with Playwright tests.