Skip to content

Django Nominopolitan

An opinionated extension for neapolitan that adds the advanced CRUD features you usually have to build yourself.

Danger

This project has been renamed to django-powercrud.

All future development will happen on the new repository. Please update your dependencies:

pip uninstall django-nominopolitan
pip install django-powercrud
For full documentation refer to django-powercrud: Getting Started


What is Nominopolitan?

The neapolitan package gives you a solid foundation for Django CRUD views. But you still need to add filtering, bulk operations, modern UX features, and styling yourself.

Nominopolitan comes with these features built-in, specifically for user-facing CRUD interfaces. Use what you need, customize what you want.

Early Alpha Release

This is a very early alpha release with limited tests and documentation. Expect breaking changes. You might prefer to fork or copy what you need.

Key Features

🎯 Advanced CRUD Operations - Filtering, bulk edit/delete, and pagination out of the box
âš¡ Modern Web UX - HTMX integration, modals, and reactive updates
🔧 Developer Friendly - Convention over configuration with full customization options
🎨 Multiple CSS Frameworks - daisyUI/Tailwind (default) and Bootstrap 5 support (partial)

Bootstrap Templates Outdated

Bootstrap templates are currently out of date as all recent development has focused on daisyUI. Once async support is finalised and tested, Bootstrap templates will either be updated or removed.

Quick Example

Start with basic neapolitan:

# Basic neapolitan
class ProjectView(CRUDView):
    model = Project

Add Nominopolitan for advanced features:

# With Nominopolitan
class ProjectView(NominopolitanMixin, CRUDView):
    model = Project
    fields = ["name", "owner", "status"]
    base_template_path = "core/base.html"

    # Modern features
    use_htmx = True
    use_modal = True

    # Advanced filtering
    filterset_fields = ["owner", "status", "created_date"]

    # Bulk operations
    bulk_fields = ["status", "owner"]
    bulk_delete = True

    # Enhanced display
    properties = ["is_overdue", "days_remaining"]

Getting Started

  1. Installation - Install and configure in minutes
  2. Quick Start - Your first Nominopolitan view
  3. Configuration - Explore the features

Framework Support

  • daisyUI/Tailwind CSS - Modern utility-first styling (default)
  • Bootstrap 5 - Production-ready components
  • Custom frameworks - Bring your own CSS