Metadata-Version: 2.4
Name: django-auth-style
Version: 0.10.0
Summary: Django template styling for django-allauth and django-oauth-toolkit.
Project-URL: Repository, https://github.com/kitware-resonant/django-auth-style
Project-URL: Bug Reports, https://github.com/kitware-resonant/django-auth-style/issues
Maintainer-email: "Kitware, Inc." <kitware@kitware.com>
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: allauth,django,django-allauth,django-oauth-toolkit,kitware-resonant,resonant,style,styling
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Framework :: Django :: 4
Classifier: Framework :: Django :: 4.2
Classifier: Framework :: Django :: 5
Classifier: Framework :: Django :: 5.1
Classifier: Framework :: Django :: 5.2
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.10
Requires-Dist: django>=4.2
Provides-Extra: allauth
Requires-Dist: django-allauth>=0.63; extra == 'allauth'
Provides-Extra: oauth-toolkit
Requires-Dist: django-oauth-toolkit; extra == 'oauth-toolkit'
Description-Content-Type: text/markdown

# django-auth-style
[![PyPI](https://img.shields.io/pypi/v/django-auth-style)](https://pypi.org/project/django-auth-style/)

django-auth-style provides Django template styling for
[django-allauth](https://django-allauth.readthedocs.io/)
and [django-oauth-toolkit](https://django-oauth-toolkit.readthedocs.io/).

## Installation
### django-allauth Support
To enable support for django-allauth, install with:
```bash
pip install django-auth-style[allauth]
```

Then enable the Django app:
```python
# settings.py
INSTALLED_APPS = [
    # Any project-local apps should come before "auth_style",
    # so templates can be overridden as needed
    'my_django_app.apps.MyDjangoAppConfig',
    ...,
    'auth_style',
    ...,
    # "allauth" must come after "auth_style"
    'allauth',
    'allauth.account',
    'allauth.socialaccount',
]
MIDDLEWARE = [
    ...,
    # CurrentSiteMiddleware is optional, but recommended to show site branding
    'django.contrib.sites.middleware.CurrentSiteMiddleware',
    ...
]
```

### django-oauth-toolkit Support
To enable support for django-oauth-toolkit, install with:
```bash
pip install django-auth-style[oauth-toolkit]
```

Then enable the Django app:
```python
# settings.py
INSTALLED_APPS = [
    # Any project-local apps should come before "auth_style",
    # so templates can be overridden as needed
    'my_django_app.apps.MyDjangoAppConfig',
    ...,
    'auth_style',
    ...,
    # "oauth2_provider" must come after "auth_style"
    'oauth2_provider',
]
```

## Usage
When django-auth-style is properly installed alongside django-allauth or django-oauth-toolkit,
rendered templates will automatically be overridden with styled alternatives.

### Template Override
To customize the site name (in the upper-left corner), create `auth_style/site_name.html` within your project's templates directory. You will be responsible for applying appropriate styling to any text.

For example:

```html
<span style="font-size: 1.5rem; font-weight: bold; color: #2563eb;">
  🚀 My Custom App
</span>
```
