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.9.1.tar.gz (5.3 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.9.1-py3-none-any.whl (704.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: conjunto-0.9.1.tar.gz
  • Upload date:
  • Size: 5.3 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.9.1.tar.gz
Algorithm Hash digest
SHA256 63a3dfea58257df33df631ea0bee90e776296cbe8ee091cc4675d17454c71941
MD5 52d0cc8f62207e37d5e0fb7ea73b7720
BLAKE2b-256 23032bf11c0f0824d89a64a004e81dd07bd6c0e8e4b2bc0cd77bb100d4bcfae3

See more details on using hashes here.

File details

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

File metadata

  • Download URL: conjunto-0.9.1-py3-none-any.whl
  • Upload date:
  • Size: 704.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.9.1-py3-none-any.whl
Algorithm Hash digest
SHA256 7d9aa01b2f5d20870c2833cb2aa9d7f827dd4fcc973de784c564d2ee943e383e
MD5 12e8d9c13982a9b08e101af9d9f834ed
BLAKE2b-256 34a68c38bde53eba3d882b39bfe14d472170fc8b2dc007404d40c45101f3cdc5

See more details on using hashes here.

Release history Release notifications | RSS feed

0.11.0

2 files

0.10.1

2 files

0.10.0

2 files

0.9.3

2 files

0.9.2

2 files

This release

0.9.1 This release

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