No project description provided
Project description
AllAuth UI
UI templates for django-allauth built with Tailwind. https://django-allauth-ui.hodovi.ch.
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 good defaults for new projects.
Table of contents
Features
- 📱 Mobile-friendly design
- 💄 Configurable themes
- 🗣️ Translations
- 🇪🇸 Spanish
- 🇫🇷 French
- 🇧🇷 Portuguese
Installation
pip install django-allauth-ui
pip install django-widget-tweaks
pip install slippers
django-allauth-ui depends on jazzband/django-widget-tweaks and mixxorz/slippers to render templates. Make sure to install both packages and add them to the INSTALLED_APPS.
Add django-allauth-ui before django-allauth in your INSTALLED_APPS. See ./tests/settings.py for an example.
INSTALLED_APPS = [
"allauth_ui",
"allauth",
"allauth.account",
"allauth.socialaccount",
"allauth.socialaccount.providers.github",
"widget_tweaks",
"slippers",
]
Note:
When going to production you should run python manage.py collectstatic
Configuration
The templates can be themed using Django settings. The theme value corresponds to DaisyUI themes.
# settings.py
ALLAUTH_UI_THEME = "light"
Hacking on the project
# 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
Made with contrib.rocks.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for django_allauth_ui-1.1.5b1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | fbd43adb524ca849b818e2cf2ecbd45529fffa4b1ea46dc763c01eb6e7deaef9 |
|
MD5 | c641e3d7ee2dd20f246a4b8ac3aac748 |
|
BLAKE2b-256 | 6b51f7bd15b80e8f9d638caeee8104a78d2059c95b0706be0d808ca6970f51d6 |
Hashes for django_allauth_ui-1.1.5b1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | c72fc0e2bb5b0f9206a5d3aa90406e4ae67f36e543c19ad5308772c994c8fdab |
|
MD5 | 457a98db93f39f054277b832cc2bd927 |
|
BLAKE2b-256 | 45c0e623ef3c121a496703a910ffac839a00954515c1d9c3dd7bcbaabfbe29c2 |