Skip to main content

Reusable workflow library for django

Project description

Viewflow is a lightweight reusable workflow library that helps to organize people collaboration business logic in django applications.

In conjunction with django-material, they could be used as the framework to build ready to use business applications in minutes.
  • Viewflow 1.1.x compatible with Django 1.8/1.9/1.10/1.11 (supported till Django 1.8 lifetime/April 2018)
  • Viewflow 1.2.x compatible with Django 1.11/2.0 (supported till Django 1.11 lifetime/April 2020)
  • Viewflow 1.3.x/1.4.x/1.5.x compatible with Django 1.11/2.0/2.1/2.2 (supported till Django 1.11 lifetime/April 2020)
  • Viewflow 1.6.x/1.7.x compatible with Django 2.0/2.1/2.2/3.0/3.1 (supported till Django 2.0 lifetime/December 2020)
  • Viewflow 1.8.x/1.9.x compatible with Django 2.1/2.2/3.0/3.1
  • Viewflow 1.10.x compatible with Django 2.2/3.0/3.1/3.2/4.0


Django web framework solves only technical problems related to the client-server interaction on top of the stateless HTTP protocol. Model-View-Template separation pattern helps to maintain simple CRUD based logic. Viewflow is the library that offers an additional layer of django web framework, allows explicitly specify people’s workflow and extracts collaboration logic from django views.

Viewflow layer is based on the BPMN - business process management and notation standard. It is the graphical notation readily understandable by all business stakeholders and software developers. Viewflow bridges the gap between a picture as the software specification and the working solution.

Django-Material frontend is the lightweight alternative to the django admin and allows you to build business applications. It’s based on Google Material Design, that could be easily customized to your brand colors. Django-Material takes care of site-wide navigation, complex form construction, datagrids and CRUD functionality. Ready for fast development of any CRM, ERP, Business Management Software.

Quick start

5 minutes introduction tutorial


Viewflow comes with reference UI implementation on top of django-material project.

To checkout and run open source demo version locally, you need to have git and tox tools installed.

git clone
cd viewflow

TOXENV=py36-dj111 tox -- python migrate --settings=demo.settings
TOXENV=py36-dj111 tox -- python loaddata demo/helloworld/fixtures/helloworld/default_data.json --settings=demo.settings
TOXENV=py36-dj111 tox -- python runserver --settings=demo.settings

Then, you can open and login with admin:admin username/password pair.


Read the documentation at the


Advanced customization samples


Please open an issue to discuss. before pushing any new functionality.

See also - Contribution Agreement


Viewflow is an Open Source project licensed under the terms of the AGPL license - The GNU Affero General Public License v3.0 with the Additional Permissions described in LICENSE_EXCEPTION

Viewflow Pro has a commercial-friendly license allowing private forks and modifications of Viewflow. You can find the commercial license terms in COMM-LICENSE. Please see FAQ for more detail.

Latest changelog

1.10.0 2021-11-12

  • Django 4.0 support
  • Fix set assigned time on auto-assign
  • Allow anonymous users to trigger flow start

Project details

Download files

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

Files for django-viewflow, version 1.10.0
Filename, size File type Python version Upload date Hashes
Filename, size django_viewflow-1.10.0-py2.py3-none-any.whl (141.0 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size django-viewflow-1.10.0.tar.gz (88.2 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page