https://github.com/johnfraney/django-bootstrap-customizer

Build customized Bootstrap CSS using the Django admin
https://github.com/johnfraney/django-bootstrap-customizer

bootstrap4 django sass scss

Last synced: 29 days ago
JSON representation

Build customized Bootstrap CSS using the Django admin

• Host: GitHub
• URL: https://github.com/johnfraney/django-bootstrap-customizer
• Owner: johnfraney
• License: mit
• Created: 2018-09-04T03:30:01.000Z (about 6 years ago)
• Default Branch: main
• Last Pushed: 2022-12-26T20:44:08.000Z (almost 2 years ago)
• Last Synced: 2024-09-27T15:21:53.833Z (about 1 month ago)
• Topics: bootstrap4, django, sass, scss
• Language: Python
• Homepage: https://johnfraney.github.io/django-bootstrap-customizer/
• Size: 1.26 MB
• Stars: 48
• Watchers: 6
• Forks: 4
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • Changelog: HISTORY.md
  • Contributing: CONTRIBUTING.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

• awesome-bootstrap - django-bootstrap-customizer - Customizable Bootstrap 4 generator for Django. [](https://opensource.org/licenses/MIT) (UI Kits & libraries / Design Tools)

README

        
# Django Bootstrap Customizer

[

![PyPI](https://img.shields.io/pypi/v/django-bootstrap-customizer.svg)

![PyPI](https://img.shields.io/pypi/pyversions/django-bootstrap-customizer.svg)

![PyPI](https://img.shields.io/pypi/djversions/django-bootstrap-customizer.svg)

![PyPI](https://img.shields.io/pypi/l/django-bootstrap-customizer.svg)

](https://pypi.org/project/django-bootstrap-customizer/)

[![TravisCI](https://travis-ci.org/johnfraney/django-bootstrap-customizer.svg?branch=master)](https://travis-ci.org/johnfraney/django-bootstrap-customizer)

Django Bootstrap Customizer lets you build a custom Bootstrap theme by creating `BootstrapTheme` models from the Django admin.

`BootstrapTheme` values are converted to Bootstrap SCSS variables that are used to compile customized Bootstrap CSS when you save your theme, using [`libsass-python`](https://github.com/sass/libsass-python) under the hood.

Enjoy tailored Bootstrap CSS without having to set up a Node front-end assets pipeline!

## Features

* Bootstrap 4.

* Generates optimized above-the-fold and below-the-fold CSS payloads, perfect for improving your site's [Google PageSpeed](https://developers.google.com/speed/docs/insights/OptimizeCSSDelivery) score.

* Customized Bootstrap themes for each site in a [multi-site](https://docs.djangoproject.com/en/dev/ref/contrib/sites/#module-django.contrib.sites) installation.

* No Node/NPM/Gulp/Webpack required.

## Documentation

Documentation is available in the [`docs` directory](./docs/index.md) and at https://johnfraney.github.io/django-bootstrap-customizer.

## Example Project

An example project is included in the `example` directory. See the [docs](https://johnfraney.github.io/django-bootstrap-customizer/) for more information.

## Screenshot

![BootstrapTheme admin](docs/images/bootstraptheme-admin.png)

## Credits

Tools used in rendering this package:

* [Bootstrap](https://github.com/twbs/bootstrap/)

* [libsass-python](https://github.com/sass/libsass-python)

* [django-colorful](https://github.com/charettes/django-colorful)

* [cssutils](https://pythonhosted.org/cssutils/index.html)

* [Cookiecutter](https://github.com/audreyr/cookiecutter)

## Code of Conduct

Everyone interacting in the project's codebases, issue trackers, chat rooms, and mailing lists is expected to follow the [PyPA Code of Conduct](https://www.pypa.io/en/latest/code-of-conduct/).