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:
Newer release available (0.11.0)

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.10.1.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.10.1-py3-none-any.whl (716.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: conjunto-0.10.1.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.10.1.tar.gz
Algorithm Hash digest
SHA256 b3a59a38e44f5471d6741cf18b30409bc60279c02e99409c941cc5f38574f8ac
MD5 c9bc4c78e3ce3623748a30500aee6cb0
BLAKE2b-256 d93a3c507b48e0abab38863b5874eced5ab4d3334142e043bd6b4973889c6db6

See more details on using hashes here.

File details

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

File metadata

  • Download URL: conjunto-0.10.1-py3-none-any.whl
  • Upload date:
  • Size: 716.6 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.10.1-py3-none-any.whl
Algorithm Hash digest
SHA256 8604107e9ac1d86b3820730f069ac891e6e56da0f917f1250e1a3c7000a95b06
MD5 405bf1c7244acc5ccc0d6908a7f14eaa
BLAKE2b-256 bef38017f7366d7143f72fd911d2412b29d587c31eefe6debd27f7cd081860a1

See more details on using hashes here.

Release history Release notifications | RSS feed

0.11.0

2 files

This release

0.10.1 This release

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