Skip to main content

AA Kanban

PyPI version Python versions Tests

Alliance Auth plugin for native Kanban boards.

Features

  • Native Kanban boards with an intuitive drag-and-drop interface for cards and columns, complete with default columns (Backlog, To Do, In Progress, Review/Testing, Done). Columns can be rearranged dynamically via drag-and-drop, and newly created columns are immediately usable without a page refresh.
  • Summary View displaying all accessible boards across standardized status columns.
  • Rich Card & Ticket Descriptions: Markdown formatting with safe, sanitized rendering. Add images by pasting (Ctrl+V), dragging-and-dropping, or using the upload button, with a live [Write] / [Preview] toggle and a fullscreen lightbox for viewing.
  • Global Labels & Card Colors: Flexibly categorize cards using global labels and individual background colors, with automatic text-contrast adjustment.
  • Member Ticket System: Allows regular members to submit tickets (cards). Tickets are automatically routed to the correct board based on the selected target team. Boards can be individually designated as ticket boards. When a Discord ticket thread is created, members of the assigned team are automatically invited to the thread.
  • Permission management: Manage read-only and write groups globally and per board directly from the frontend UI. Easily authorize large numbers of members by linking Django Auth Groups directly to Kanban groups. Board/settings management access can also be granted per Kanban Group (can_manage_boards) entirely from the frontend, without needing Django admin access.
  • Discord Integrations: Receive notifications via Webhooks when boards are created or cards are moved. Ticket threads are automatically generated in configured channels, and Discord DM notifications are sent directly to users when they are assigned to cards (requires the aadiscordbot app).
  • Multilingual Support: Fully supports English and Dutch language interfaces.

Documentation

For a comprehensive guide covering all features, workflows, and frontend administration with screenshots, please see the User & Administration Manual.

Installation

pip install aa-kanban

Add the app to your local.py:

INSTALLED_APPS += [
    "aa_kanban",
]

Run the database migrations:

python manage.py migrate

Gather static files:

python manage.py collectstatic

Restart your supervisor services to load the new code (e.g., gunicorn and celery).

Discord Webhooks Configuration

To receive updates in your Discord channels, you can configure webhooks in the Django Admin panel:

  1. Global Board Creation Webhook:
    • Go to Admin > Kanban Settings > Global Kanban Settings.
    • Fill in the Board creation webhook field with your Discord Webhook URL. You will receive a message whenever a new board is created.
  2. Board-Specific Card Movement Webhooks:
    • Go to Admin > Boards and edit a specific board.
    • Fill in the Discord webhook cards field. Any card movements between lists on this board will be posted to this webhook.
  3. Board-Specific Ticket Channel:
    • Go to Admin > Boards and edit a specific board.
    • Fill in the Discord Ticket Channel ID field. New tickets submitted to this board will automatically create a thread in this channel. If the ticket is assigned to a KanbanTeam, all team members will be automatically invited to the thread.

Settings

You can customize the application by adding the following settings to your local.py:

# Change the name of the app in the Alliance Auth sidebar menu (default: "Kanban")
AA_KANBAN_APP_NAME = "Ticket System" 

Periodic Tasks (Celery Beat)

To enable automatic hourly alerts for stale/inactive cards on boards that have stale_card_alert_hours configured, add the following task to your local.py:

CELERYBEAT_SCHEDULE["aa_kanban_check_stale_cards"] = {
    "task": "aa_kanban.tasks.check_stale_cards",
    "schedule": crontab(minute="0", hour="*"),
}

To enable daily auto-archiving of cards that have sat in a board's last list past its configured archive_after_days, add:

CELERYBEAT_SCHEDULE["aa_kanban_archive_done_cards"] = {
    "task": "aa_kanban.tasks.archive_done_cards",
    "schedule": crontab(minute="0", hour="3"),
}

Metadata

Release files for aa-kanban 1.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for aa-kanban 1.1.0
File Size Uploaded Provenance Actions
aa_kanban-1.1.0.tar.gz 137.5 kB With provenance Details for aa_kanban-1.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for aa-kanban 1.1.0
File Interpreter ABI Platform Actions
aa_kanban-1.1.0-py3-none-any.whl Python 3 none any Details for aa_kanban-1.1.0-py3-none-any.whl

Total release size: 329.9 kB

Release files / aa_kanban-1.1.0.tar.gz

Download URL aa_kanban-1.1.0.tar.gz
Size 137.5 kB
Tags Source
SHA-256 checksum
How to use checksums
96ea4d44806cc3b48985826b4108fca303de15fd62b0fea13d1d79d1247c9b7b
BLAKE2b-256 checksum
How to use checksums
2f4e37a65a3c88b711a14a2ec3fe41ffa8e38a8023dce4a7ac0db715d09f6b62
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 2, 2026.

Transparency log

Release files / aa_kanban-1.1.0-py3-none-any.whl

Download URL aa_kanban-1.1.0-py3-none-any.whl
Size 192.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
5efcf0b121497f3a42dc71ff2feaf939762316ef95d951c1639dbc4ed3f30b60
BLAKE2b-256 checksum
How to use checksums
52aeea1f28ba42f3f110e6a43eff44f36d4bef8b13569320f5976279c7bb860c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 2, 2026.

Transparency log

Security for aa-kanban 1.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for aa_kanban-1.1.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 2, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.1.0 This release

2 release files Full provenance

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