Metadata-Version: 2.1
Name: django-allauth-ui
Version: 0.3.4
Summary: 
Home-page: https://github.com/danihodovic/django-webhook
License: MIT
Keywords: django,allauth,social-login,auth
Author: Dani Hodovic
Author-email: you@example.com
Requires-Python: >=3.8,<4.0.0
Classifier: Framework :: Django
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: System :: Systems Administration :: Authentication/Directory
Requires-Dist: django-widget-tweaks (>=1.4.12,<2.0.0)
Project-URL: Repository, https://github.com/danihodovic/django-webhook
Description-Content-Type: text/markdown

# AllAuth UI

UI templates for [django-allauth](https://github.com/pennersr/django-allauth)
built with Tailwind.

django-allauth is a great library, but the templates it provides out of the box
are minimal html. I usually end up re-designing the login / logout / signup
pages for each new Django project. This library aims at providing decent
defaults for new projects.

* [AllAuth UI](#allauth-ui)
* [Features](#features)
* [Installation](#installation)
* [Screenshots](#screenshots)
   * [Generating screenshots](#generating-screenshots)
* [Hacking on the project](#hacking-on-the-project)
* [Contributors](#contributors)

## Features

- Responsive design suitable for device sizes from mobile to desktop
- Styled social login themes
- Additional error information when [social logins fail](https://github.com/pennersr/django-allauth/issues/2142)

## Installation


```
pip install django-allauth-ui
pip install django-widget-tweaks
```

django-allauth-ui depends on django-widget-tweaks to render form fields. Make
sure to install django-widget-tweaks and add it to the INSTALLED_APPS.

Add django-allauth-ui **before** django-allauth in your INSTALLED_APPS. See
[./tests/settings.py](./tests/settings.py) for an example.

```python
INSTALLED_APPS = [
    "allauth_ui",
    "allauth",
    "allauth.account",
    "allauth.socialaccount",
    "allauth.socialaccount.providers.github",
    "widget_tweaks",
]
```
**Note**:

When going to **production** you should run ```python manage.py collectstatic```

## Screenshots

![Log In](./images/signin.png)
![Sign Up](./images/signup.png)
![Password Reset](./images/password_reset.png)

### Generating screenshots

```
convert "$1" -crop 1072x901+436+200 crop_signin.png
```

### Hacking on the project

```sh
# Clone the repo
git clone git@github.com:danihodovic/django-allauth-ui.git
cd django-allauth-ui.git

# Create the virtual env
python -m venv .venv
# Activate the virtual env. This has to be done every time you enter the directory.
source .venv/bin/activate

# Install the dependencies
pip install --upgrade pip poetry
poetry install

# Install tailwind
npm install

# Run the migrations
./manage.py migrate

# Add sample social providers
./manage.py create_test_providers

# Start the server
./manage.py runserver_plus

# Start the tailwind compilation process in another terminal
npm run-script build:watch
```

Make changes in allauth_ui/templates and open the browser at http://localhost:8000/accounts/login/.

Once you're done compile tailwind with `npm run-script build` and submit a pull-request 🃏

## Contributors
[<img alt="EVELYN-RYAN" src="https://avatars.githubusercontent.com/u/72516405?v=4&s=117" width="117">](https://github.com/EVELYN-RYAN)[<img alt="filip-dobrovolny-csob-cz" src="https://avatars.githubusercontent.com/u/95356884?v=4&s=117" width="117">](https://github.com/filip-dobrovolny-csob-cz)[<img alt="mohmyo" src="https://avatars.githubusercontent.com/u/14170159?v=4&s=117" width="117">](https://github.com/mohmyo)[<img alt="twolfson" src="https://avatars.githubusercontent.com/u/902488?v=4&s=117" width="117">](https://github.com/twolfson)[<img alt="anyidea" src="https://avatars.githubusercontent.com/u/48710760?v=4&s=117" width="117">](https://github.com/anyidea)[<img alt="danihodovic" src="https://avatars.githubusercontent.com/u/5557301?v=4&s=117" width="117">](https://github.com/danihodovic)

