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.
  • Board overview: Every board shows its number of cards and flags cards that need attention: past their due date, inactive past the board's stale-alert hours, or in a column over its WIP limit.
  • 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.2.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.2.0
File Size Uploaded Provenance Actions
aa_kanban-1.2.0.tar.gz 140.6 kB With provenance Details for aa_kanban-1.2.0.tar.gz

Built distribution (wheel)

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

Total release size: 337.0 kB

Release files / aa_kanban-1.2.0.tar.gz

Download URL aa_kanban-1.2.0.tar.gz
Size 140.6 kB
Tags Source
SHA-256 checksum
How to use checksums
7ffb84d69edb673e4df4de07896a36b575af639127c8602075ffc1d26eddbb7b
BLAKE2b-256 checksum
How to use checksums
5eeff38977da9be2951c038617ebc2a28faf3be5ff8610df6e91275b13fc2fdf
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 5, 2026.

Transparency log

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

Download URL aa_kanban-1.2.0-py3-none-any.whl
Size 196.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
5f176a8a3576c687eb0c48c53705c30e10806bad75121749fea240e69da9b4c9
BLAKE2b-256 checksum
How to use checksums
71385004a75c22f4addd60b78e2603f8f11a4325c7494a6604b31b7e3fb5048b
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 5, 2026.

Transparency log

Security for aa-kanban 1.2.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.2.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 5, 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.2.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