A Bulma Theme for Django Projects

Django Bulma

A Django base theme based on Bulma (bulma.io). Bulma is a modern CSS framework based on Flexbox.

*** work in progress ***

Installation

Install the python package django-bulma from pip

pip install django-bulma

Alternatively, you can install download or clone this repo and call pip install -e ..

Add to INSTALLED_APPS in your settings.py:

'bulma',

If you want to use the provided base template, extend from bulma/base.html:

{% extends 'bulma/base.html' %}

{% block title %}Bulma Site{% endblock %}

{% block content %}
  Content goes here...
{% endblock content %}

If you want to customize bulma sass and your own components:

4.1 Copy bulma static files into your project's STATIC_ROOT:
```
python manage.py copy_bulma_static_into_project
```
You should see bulma dir appeared in your STATIC_ROOT. It contains two dirs:
- sass - this is the place where you can put your own sass code and customize bulma variables
- css - this is where compiled sass output goes, you should link this file in your base.html
4.2 Install npm packages for sass compilation to work:
```
python manage.py bulma install
```
4.3 Start sass watch mode:
```
python manage.py bulma start
```

For forms, in your templates, load the bulma_tags library and use the |bulma filters:

Example template

{% load bulma_tags %}

{# Display a form #}

<form action="/url/to/submit/" method="post">
   {% csrf_token %}
   {{ form|bulma }}
   <div class="field">
     <button type="submit" class="button is-primary">Login</button>
   </div>
   <input type="hidden" name="next" value="{{ next }}"/>
</form>

Included templates

django-bulma comes with:

a base template,
django core registration templates,

Bugs and suggestions

If you have found a bug or if you have a request for additional functionality, please use the issue tracker on GitHub.

https://github.com/timonweb/django-bulma/issues

2017 - 2025 (c) Tim Kamanin - A Full Stack Django and Wagtail Developer

Release files for django-bulma 0.11.2

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

Source distribution (sdist)

Source distribution for django-bulma 0.11.2
File	Size	Uploaded
django_bulma-0.11.2.tar.gz	227.5 kB	Apr 23, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for django-bulma 0.11.2
File	Interpreter	ABI	Platform	Reset
django_bulma-0.11.2-py3-none-any.whl 204.2 kB Apr 23, 2026	Python 3	none	any	Details

Total release size: 431.7 kB

Release files / django_bulma-0.11.2.tar.gz

Download URL	django_bulma-0.11.2.tar.gz
Size	227.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`0e0e858d67e4d8c8e51a98ccd953dca930eaaa91031ddafa3b8a09017eb2f374`
BLAKE2b-256 checksum How to use checksums	`271816ca7ef155479a29a263129554a201ee62ffb84d48a0a665350bfb7f4cb0`
Upload date	Apr 23, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.12`

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.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/timonweb/django-bulma
Publishing commit: github.com/timonweb/django-bulma/tree/05a3e2c26d344723be8472dd884bb0bdc0853421

Workflow

Publishing configuration: github.com/timonweb/django-bulma/blob/05a3e2c26d344723be8472dd884bb0bdc0853421/.github/workflows/release.yml
Publishing logs: github.com/timonweb/django-bulma/actions/runs/24828145566/attempts/1

Artifact

Subject: django_bulma-0.11.2.tar.gz
SHA-256 checksum: 0e0e858d67e4d8c8e51a98ccd953dca930eaaa91031ddafa3b8a09017eb2f374 Verifying attestations

Release files / django_bulma-0.11.2-py3-none-any.whl

Download URL	django_bulma-0.11.2-py3-none-any.whl
Size	204.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`306d486ed1121a5d538194a2982d31562fae57fcd6cccc4d1d764c0515a00af8`
BLAKE2b-256 checksum How to use checksums	`8ad070755366275284cc5b36050f26d837b1ca4a51e8ec7ca22a301cbf07fdc0`
Upload date	Apr 23, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.12`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/timonweb/django-bulma
Publishing commit: github.com/timonweb/django-bulma/tree/05a3e2c26d344723be8472dd884bb0bdc0853421

Workflow

Publishing configuration: github.com/timonweb/django-bulma/blob/05a3e2c26d344723be8472dd884bb0bdc0853421/.github/workflows/release.yml
Publishing logs: github.com/timonweb/django-bulma/actions/runs/24828145566/attempts/1

Artifact

Subject: django_bulma-0.11.2-py3-none-any.whl
SHA-256 checksum: 306d486ed1121a5d538194a2982d31562fae57fcd6cccc4d1d764c0515a00af8 Verifying attestations