Htmx Django

Cursor-Regel für HTMX in Django-Projekten: Partial-Views, Formulare und CSRF korrekt verdrahtet.

Original-Beschreibung der Autoren: Cursor rules for HTMX development with Django integration.

Die Regel

---
description: "Cursor rules for HTMX development with Django integration."
globs: **/*
alwaysApply: false
---
// HTMX with Django .cursorrules

// HTMX and Django best practices

const htmxDjangoBestPractices = [
  "Use Django's template system with HTMX attributes",
  "Implement Django forms for form handling",
  "Utilize Django's URL routing system",
  "Use Django's class-based views for HTMX responses",
  "Implement Django ORM for database operations",
  "Utilize Django's middleware for request/response processing",
];

// Folder structure

const folderStructure = `
project_name/
  app_name/
    templates/
    static/
      css/
      js/
    models.py
    views.py
    urls.py
  project_name/
    settings.py
    urls.py
manage.py
`;

// Additional instructions

const additionalInstructions = `
1. Use Django's template tags with HTMX attributes
2. Implement proper CSRF protection with Django's built-in features
3. Utilize Django's HttpResponse for HTMX-specific responses
4. Use Django's form validation for HTMX requests
5. Implement proper error handling and logging
6. Follow Django's best practices for project structure
7. Use Django's staticfiles app for managing static assets
`;

So nutzt du sie

Die Regel kopieren (Button oben) oder als Datei herunterladen und im Projekt unter .cursor/rules/ ablegen — Cursor lädt sie beim nächsten Start automatisch. Ältere Cursor-Versionen lesen alternativ eine einzelne .cursorrules-Datei im Projektstamm; dort einfach den Regel-Text ohne den Kopfblock zwischen den ----Zeilen einfügen.

Der Regel-Text ist englisch — Cursor versteht ihn unabhängig von der Sprache, in der Sie mit dem Editor chatten.

Im Detail

Aufbauend auf dem HTMX-Grundprinzip verdrahtet diese Regel HTMX speziell mit Django: Views geben Partial-Templates statt vollständiger Seiten zurück, Formulare nutzen Djangos CSRF-Token korrekt in HTMX-Requests, und es wird sauber zwischen vollständigen Seiten-Views und Partial-Views für dynamische Interaktionen getrennt. Das spart typische Stolperfallen wie vergessene CSRF-Header oder falsch gerenderte Templates bei HTMX-Requests. Relevant für Django-Projekte, die auf ein separates SPA-Frontend verzichten, aber trotzdem dynamische Interaktionen wie Live-Filter oder Inline-Formulare wollen. Für API-first-Projekte mit separatem Frontend über DRF ist sie nicht die richtige Wahl.

Praxis-Tipp

Bitten Sie z. B. um „eine HTMX-Inline-Bearbeitung für ein Django-Model“ — die Regel liefert CSRF-Token und Partial-Template gleich mit.

Lizenz & Quelle

• Lizenz: CC0 1.0
• Quelle: PatrickJS/awesome-cursorrules (GitHub)

Lade …