# django-bootstrap3
[](https://github.com/zostera/django-bootstrap3/actions?workflow=test)
[](https://coveralls.io/github/zostera/django-bootstrap3?branch=main)
[](https://pypi.python.org/pypi/django-bootstrap3)
Bootstrap 3 for Django.
## Goal
The goal of this project is to seamlessly blend Django and Bootstrap 3.
## Maintenance Mode
Bootstrap 3 has been superseded by Bootstrap 4, which has since been superseded by Bootstrap 5. As a result, this package is now in **maintenance mode** and will only receive bug fixes and security updates. No new features or enhancements will be added. We recommend that new projects use Bootstrap 5 and encourage existing projects to consider migrating when feasible.
For Bootstrap 4, please refer to our dedicated package: [django-bootstrap4](https://github.com/zostera/django-bootstrap4).
For Bootstrap 5, please refer to our dedicated package: [django-bootstrap5](https://github.com/zostera/django-bootstrap5).
For icons, we recommend our dedicated package: [django-icons](https://github.com/zostera/django-icons).
## Requirements
This package requires a combination of Python and Django that is currently supported.
See "Supported Versions" on https://www.djangoproject.com/download/.
## Documentation
The full documentation is at https://django-bootstrap3.readthedocs.io/
## Installation
1. Install using pip:
```shell script
pip install django-bootstrap3
```
Alternatively, you can install download or clone this repo and call ``pip install -e .``.
2. Add to `INSTALLED_APPS` in your `settings.py`:
```python
INSTALLED_APPS = (
# ...
"bootstrap3",
# ...
)
````
3. In your templates, load the `bootstrap3` library and use the `bootstrap_*` tags:
## Example template
```djangotemplate
{% load bootstrap3 %}
{# Display a form #}
<form action="/url/to/submit/" method="post" class="form">
{% csrf_token %}
{% bootstrap_form form %}
{% buttons %}
<button type="submit" class="btn btn-primary">Submit</button>
{% endbuttons %}
</form>
```
Example app
-----------
An example app is provided in `example`. You can run it with `make example`.
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/zostera/django-bootstrap3/issues
License
-------
You can use this under BSD-3-Clause. See [LICENSE](LICENSE) file for details.
Author
------
Developed and maintained by [Zostera](https://zostera.nl).
Original author: [Dylan Verheul](https://github.com/dyve).
Thanks to everybody that has contributed pull requests, ideas, issues, comments and kind words.
Please see [AUTHORS](AUTHORS) for a list of contributors.
Raw data
{
"_id": null,
"home_page": null,
"name": "django-bootstrap3",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "django, bootstrap, bootstrap3",
"author": "Dylan Verheul",
"author_email": "Dylan Verheul <dylan@dyve.net>",
"download_url": "https://files.pythonhosted.org/packages/27/8b/a62a53b53275ff9b7e8c207a1dffafbfb6727d9f55fcbc0b37abede95ea7/django_bootstrap3-25.2.tar.gz",
"platform": null,
"description": "# django-bootstrap3\n\n[](https://github.com/zostera/django-bootstrap3/actions?workflow=test)\n[](https://coveralls.io/github/zostera/django-bootstrap3?branch=main)\n[](https://pypi.python.org/pypi/django-bootstrap3)\n\nBootstrap 3 for Django.\n\n## Goal\n\nThe goal of this project is to seamlessly blend Django and Bootstrap 3.\n\n## Maintenance Mode\n\nBootstrap 3 has been superseded by Bootstrap 4, which has since been superseded by Bootstrap 5. As a result, this package is now in **maintenance mode** and will only receive bug fixes and security updates. No new features or enhancements will be added. We recommend that new projects use Bootstrap 5 and encourage existing projects to consider migrating when feasible.\n\nFor Bootstrap 4, please refer to our dedicated package: [django-bootstrap4](https://github.com/zostera/django-bootstrap4).\n\nFor Bootstrap 5, please refer to our dedicated package: [django-bootstrap5](https://github.com/zostera/django-bootstrap5).\n\nFor icons, we recommend our dedicated package: [django-icons](https://github.com/zostera/django-icons).\n\n## Requirements\n\nThis package requires a combination of Python and Django that is currently supported.\n\nSee \"Supported Versions\" on https://www.djangoproject.com/download/.\n\n## Documentation\n\nThe full documentation is at https://django-bootstrap3.readthedocs.io/\n\n## Installation\n\n1. Install using pip:\n\n ```shell script\n pip install django-bootstrap3\n ```\n\n Alternatively, you can install download or clone this repo and call ``pip install -e .``.\n\n2. Add to `INSTALLED_APPS` in your `settings.py`:\n\n ```python\n INSTALLED_APPS = (\n # ...\n \"bootstrap3\",\n # ...\n )\n ````\n\n3. In your templates, load the `bootstrap3` library and use the `bootstrap_*` tags:\n\n## Example template\n\n```djangotemplate\n{% load bootstrap3 %}\n\n{# Display a form #}\n\n<form action=\"/url/to/submit/\" method=\"post\" class=\"form\">\n {% csrf_token %}\n {% bootstrap_form form %}\n {% buttons %}\n <button type=\"submit\" class=\"btn btn-primary\">Submit</button>\n {% endbuttons %}\n</form>\n```\n\nExample app\n-----------\n\nAn example app is provided in `example`. You can run it with `make example`.\n\n\nBugs and suggestions\n--------------------\n\nIf you have found a bug or if you have a request for additional functionality, please use the issue tracker on GitHub.\n\nhttps://github.com/zostera/django-bootstrap3/issues\n\n\nLicense\n-------\n\nYou can use this under BSD-3-Clause. See [LICENSE](LICENSE) file for details.\n\n\nAuthor\n------\n\nDeveloped and maintained by [Zostera](https://zostera.nl).\n\nOriginal author: [Dylan Verheul](https://github.com/dyve).\n\nThanks to everybody that has contributed pull requests, ideas, issues, comments and kind words.\n\nPlease see [AUTHORS](AUTHORS) for a list of contributors.\n",
"bugtrack_url": null,
"license": null,
"summary": "Bootstrap 3 for Django",
"version": "25.2",
"project_urls": {
"Changelog": "https://github.com/zostera/django-bootstrap3/blob/main/CHANGELOG.md",
"Documentation": "https://django-bootstrap3.readthedocs.io/",
"Homepage": "https://github.com/zostera/django-bootstrap3",
"Issues": "https://github.com/zostera/django-bootstrap3/issues",
"Source": "https://github.com/zostera/django-bootstrap3"
},
"split_keywords": [
"django",
" bootstrap",
" bootstrap3"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "a452630b2d5458a0e4e6a415e98ac6a713676bd9f648bf91b0e023bff3ae4133",
"md5": "f3436df509783ad5f3f44754af2790e6",
"sha256": "314ee145a69af5d52f77e41a67a6d93dcb30870454e34858ca74bd42f789fb06"
},
"downloads": -1,
"filename": "django_bootstrap3-25.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "f3436df509783ad5f3f44754af2790e6",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 24292,
"upload_time": "2025-07-31T06:49:49",
"upload_time_iso_8601": "2025-07-31T06:49:49.385633Z",
"url": "https://files.pythonhosted.org/packages/a4/52/630b2d5458a0e4e6a415e98ac6a713676bd9f648bf91b0e023bff3ae4133/django_bootstrap3-25.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "278ba62a53b53275ff9b7e8c207a1dffafbfb6727d9f55fcbc0b37abede95ea7",
"md5": "4c938d4f49d8f3af17018199d367225c",
"sha256": "79b886c1dbd6600650bc5bc046e532c98887c19ea1de8b7138a00fcfeb74a500"
},
"downloads": -1,
"filename": "django_bootstrap3-25.2.tar.gz",
"has_sig": false,
"md5_digest": "4c938d4f49d8f3af17018199d367225c",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 112399,
"upload_time": "2025-07-31T06:49:51",
"upload_time_iso_8601": "2025-07-31T06:49:51.240138Z",
"url": "https://files.pythonhosted.org/packages/27/8b/a62a53b53275ff9b7e8c207a1dffafbfb6727d9f55fcbc0b37abede95ea7/django_bootstrap3-25.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-31 06:49:51",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "zostera",
"github_project": "django-bootstrap3",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "django-bootstrap3"
}
JSON
