A Bulma Theme for Django Projects

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

*** work in progress ***

Installation

1. 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 ..

1. Add to INSTALLED_APPS in your settings.py:

'bulma',

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

```

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

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

```

1. 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

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

   Example template

   ```django

   {% load bulma_tags %}

   {# Display a form #}

   {% csrf_token %} {{ form|bulma }}

   Login
   ```

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