/crispy-bulma

Bulma template pack for django-crispy-forms

Primary LanguagePythonMIT LicenseMIT

crispy-bulma

GitHub Workflow Status PyPI PyPI - Python Version PyPI - Django Version

Bulma template pack for django-crispy-forms

Documentation: https://crispy-bulma.readthedocs.io.

Requirements

Officially supported versions:

  • Django: 3.2, 4.0, 4.1, 4.2
  • Python 3.8, 3.9, 3.10, 3.11, 3.12
  • django-crispy-forms 2.0
  • Bulma.css 0.9.4

Django 4.0+ requires crispy-bulma version 0.6.0+ and django-crispy-forms version 1.13+.

For django-crispy-forms versions older than 2.0 use crispy-bulma<=0.8.3

Quickstart

Install this plugin using pip:

$ pip install crispy-bulma

You will need to update your project's settings file to add crispy_forms and crispy_bulma to your projects INSTALLED_APPS. Also set bulma as and allowed template pack and as the default template pack for your project:

INSTALLED_APPS = (
    ...
    "crispy_forms",
    "crispy_bulma",
    ...
)

CRISPY_ALLOWED_TEMPLATE_PACKS = ("bulma",)

CRISPY_TEMPLATE_PACK = "bulma"

Credits

Related projects

crispy-bulma's focus is on form handling. This project assumes that you have already integrated bulma into your project, either manually or using some other package. If crispy-bulma does not meet your needs maybe one of these projects is of interest to you:

  • django-bulma - an alternative way to use bulma forms. Does not use crispy forms.
  • django-simple-bulma - can be used together with this project. Provides bulma integration and ads support for bulma extensions.

License

MIT license