Conjunto

A Django framework for component-based, plugin-extendable web applications.

Conjunto bundles a curated, opinionated stack so you can build modern, interactive Django apps without wiring the same plumbing together every time:

  • GDAPS — plugin architecture: drop-in apps extend the host through typed interfaces, auto-discovered at startup.
  • Tabler.io (Bootstrap 5) — a complete, themeable admin/app UI kit (light & dark).
  • HTMX — server-rendered interactivity without a SPA build step.
  • django-tables2 + crispy-forms — declarative tables, filters and forms.

The result is a batteries-included foundation for multi-tenant, permission-aware line-of-business applications.

What's in the box

Area What you get
Plugins (GDAPS) Extend menus, settings, tables, login and more via I… interfaces — no host code changes.
Layout app_base.html (topbar, collapsible sidebar, statusbar, offcanvas) and a chrome-less base.html. Server-side theming avoids the dark-mode flash.
Menus IMenuItem registry for topbar, sidebar (2 levels), user dropdown and footer — permission- and visibility-aware.
Scoped settings Layered settings resolution USER > DEVICE > GROUP > TENANT > VENDOR with lockable floors; typed registry, DB-backed, request-cached.
Settings UI Plugin-extendable settings page (ISettingsGroup / ISettingsSection / ISettingsForm) with HTMX save-in-place.
Tenants Multi-tenancy: AbstractTenant, membership & runtime-editable roles, tenant-scoped model managers, and a tenant picker.
Tables & lists TableListView with search, filters, row/header actions and HTMX modals — pluggable via IRowAction / IHeaderAction.
Forms Smart TimeField/TimePickerInput, DatePickerInput, dependent-fields HTMX wiring, persistent file fields, safe-HTML fields.
Toasts & messages Django messages surfaced as Tabler toasts on both full loads and HTMX swaps.
Audit log log_action() + a pluggable action registry.
Dashboard widgets Lazy-loading, reorderable (Gridstack) HTMX widgets with per-user layout.
Auth Plugin-extendable login (ILoginMethod, ILoginViewExtension, IPostLoginAction), remember-me, two-step tenant pick.
Archive Soft-delete + versioning + retention (no django-safedelete needed).
Wizard Multi-step form wizard with session drafts.
Sortable lists Fully HTMX-declarative drag-and-drop ordering for FK-linked models.
Profiles & avatars Optional UserProfile with avatar, plus an always-available {% avatar %} tag.
Optional extras Block CMS (conjunto[cms]) and at-rest encryption (conjunto[crypto]).

Requirements

  • Python ≥ 3.12
  • Django ≥ 6.0

Installation

pip install conjunto            # or: uv add conjunto

Optional subsystems:

pip install "conjunto[cms]"     # block CMS (pulls in django-polymorphic)
pip install "conjunto[crypto]"  # at-rest field/file encryption (pulls in cryptography)

Quick setup

1. Register the app. Add conjunto before django_extensions (it overrides the update_permissions command), and add gdaps for plugin discovery:

INSTALLED_APPS = [
    # ...
    "conjunto",
    "django_extensions",
    "gdaps",
    # optional: "conjunto.profiles", "conjunto.cms", ...
]

2. Add the middleware (order matters — TimezoneMiddleware after ConjuntoMiddleware; ConjuntoMessagesMiddleware after Django's MessageMiddleware and after django_htmx's HtmxMiddleware):

MIDDLEWARE = [
    # ...
    "django.contrib.messages.middleware.MessageMiddleware",
    "django_htmx.middleware.HtmxMiddleware",
    "conjunto.middleware.ConjuntoMiddleware",
    "conjunto.middleware.ConjuntoMessagesMiddleware",
    "conjunto.middleware.TimezoneMiddleware",
]

3. Fetch the front-end libraries. Third-party JS/CSS (Tabler, HTMX, Alpine, TinyMCE, …) are not bundled in the wheel — download them into your project's static tree once:

python manage.py update_libraries --suggest   # prints a CONJUNTO_LIBRARIES = [...] block
# paste it into settings.py, then:
python manage.py update_libraries             # download the files
python manage.py update_libraries --check     # CI guard (no network)

This keeps the wheel small (~1 MB instead of ~16 MB) and puts library versions under your control. See docs/usage/static_libraries.md for CONJUNTO_VENDOR_DIR, STATICFILES_DIRS and CI integration.

The installation guide covers the remaining settings (context processors, .env, layout).

Usage

Full documentation lives under docs/ — start with the layout, menus, scoped settings and tenants guides.

Development

uv sync                          # install deps (dev group included)
uv run pytest                    # run the test suite
uv run pytest tests/test_x.py    # run a single test module
uv run black .                   # format
uv build                         # build the wheel

Formatting is enforced with Black ≥ 25.12.0. Tests run against a bundled test app in tests/.

Contributing

Pull requests and ideas are welcome. For major changes, please open an issue first to discuss the direction.

License

Conjunto is open source under the MIT License. Note that it integrates many third-party libraries, which carry their own (possibly different) licenses — see THIRD_PARTY_LICENSES.md.

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for nerdoc from gravatar.com nerdoc

Credits

Author: Christian González

License expression

MIT
View SPDX License List

Requires

Python >=3.12

Provides Extra

crypto cms

Tags

python django framework i18n

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

conjunto-0.11.0.tar.gz (5.4 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

conjunto-0.11.0-py3-none-any.whl (721.7 kB view details)

Uploaded Python 3

File details

Details for the file conjunto-0.11.0.tar.gz.

File metadata

  • Download URL: conjunto-0.11.0.tar.gz
  • Upload date:
  • Size: 5.4 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.9.30 {"installer":{"name":"uv","version":"0.9.30","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"12","id":"bookworm","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for conjunto-0.11.0.tar.gz
Algorithm Hash digest
SHA256 7b14745fb562e71ec7c4a5a5daf492aa136249d0e10840fe40a1461b6f38bcaa
MD5 1d00e6224ae21ecd0c705a204afc1bec
BLAKE2b-256 480c077a8dbdbc3e42214460aa2560f3fb0785bdd6b90e31569dc8627bfd23bd

See more details on using hashes here.

File details

Details for the file conjunto-0.11.0-py3-none-any.whl.

File metadata

  • Download URL: conjunto-0.11.0-py3-none-any.whl
  • Upload date:
  • Size: 721.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.9.30 {"installer":{"name":"uv","version":"0.9.30","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"12","id":"bookworm","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for conjunto-0.11.0-py3-none-any.whl
Algorithm Hash digest
SHA256 ffd492008fe05d93a4ae8dbd7c84c3f3eed05d1a7c14241fc972a00ebe9cda7e
MD5 f31614b112c6ad71c502738dd0f7c922
BLAKE2b-256 eac72f0ab0abe1ea67c4cec6835e08b3935e1c0529ddb9b493196e42cafd9b61

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

0.11.0 This release

2 files

0.10.1

2 files

0.10.0

2 files

0.9.3

2 files

0.9.2

2 files

0.9.1

2 files

0.9.0

2 files

0.8.0

2 files

0.7.16

2 files

0.7.15

2 files

0.7.14

2 files

0.7.13

2 files

0.7.12

2 files

0.7.11

2 files

0.7.10

2 files

0.7.9

2 files

0.7.8

2 files

0.7.7

2 files

0.7.6

2 files

0.7.5

2 files

0.7.4

2 files

0.7.2

2 files

0.7.1

2 files

0.7.0

2 files

0.6.0

2 files

0.5.7

2 files

0.5.6

2 files

0.5.5

2 files

0.5.4

2 files

0.5.3

2 files

0.5.2

2 files

0.5.1

2 files

0.5.0

2 files

0.4.2

2 files

0.4.1

2 files

0.4.0

2 files

0.3.2

2 files

0.3.1

2 files

0.3.0

2 files

0.2.1

2 files

0.1.2

2 files

0.1.1

2 files

0.0.25

2 files

0.0.24

2 files

0.0.23

2 files

0.0.22

2 files

0.0.21

2 files

0.0.20

2 files

0.0.19

2 files

0.0.18

2 files

0.0.17

2 files

0.0.16

2 files

0.0.15

2 files

0.0.14

2 files

0.0.13

2 files

0.0.12

2 files

0.0.11

2 files

0.0.10

2 files

0.0.9

2 files

0.0.8

2 files

0.0.7

2 files

0.0.6

2 files

0.0.5

2 files

0.0.4

2 files

0.0.3

2 files

0.0.2

2 files

0.0.1

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page