django-allauth-ui


Namedjango-allauth-ui JSON
Version 1.6.1 PyPI version JSON
download
home_pagehttps://github.com/danihodovic/django-allauth-ui
SummaryNone
upload_time2025-02-15 22:08:38
maintainerNone
docs_urlNone
authorDani Hodovic
requires_python>=3.8
licenseMIT
keywords django allauth social-login auth
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls. 
            # AllAuth UI

![django-allauth-ui](./django-allauth-vs-allauth-ui.png)


UI templates for [django-allauth](https://github.com/pennersr/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](#features)
* [Installation](#installation)
* [Configuration](#configuration)
* [Hacking on the project](#hacking-on-the-project)
* [Contributors](#contributors)

## Features

- 📱 Mobile-friendly design
- 💄 [Configurable themes](https://daisyui.com/docs/themes/)
- 🕵️ Support for [Allauth User Sessions](https://docs.allauth.org/en/latest/usersessions/index.html)
- 📱Support for [Multi-Factor Authentication](https://docs.allauth.org/en/latest/mfa/index.html)
- 🗣️ Translations
  - 🇪🇸 Spanish
  - 🇫🇷 French
  - 🇧🇷 Portuguese
  - 🇹🇷 Turkish

## Installation

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

django-allauth-ui depends on [jazzband/django-widget-tweaks](https://github.com/jazzband/django-widget-tweaks)
and [mixxorz/slippers](https://github.com/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](./tests/settings.py) for an example.

```python
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](https://daisyui.com/docs/themes/).

```python
# settings.py
ALLAUTH_UI_THEME = "light"
```

## Hacking on the project

- Install direnv: https://direnv.net/docs/installation.html
- Setup direnv: https://direnv.net/docs/hook.html

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

# Active the virtual env
direnv allow

# 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
<a href="https://github.com/danihodovic/django-allauth-ui/graphs/contributors">
  <img src="https://contrib.rocks/image?repo=danihodovic/django-allauth-ui" />
</a>

Made with [contrib.rocks](https://contrib.rocks).

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/danihodovic/django-allauth-ui",
    "name": "django-allauth-ui",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": null,
    "keywords": "django, allauth, social-login, auth",
    "author": "Dani Hodovic",
    "author_email": "you@example.com",
    "download_url": "https://files.pythonhosted.org/packages/ba/5e/77fb367763c305b79a93f8c4bded0dfb2fb39b26df3b7c1d42e3e49d8225/django_allauth_ui-1.6.1.tar.gz",
    "platform": null,
    "description": "# AllAuth UI\n\n![django-allauth-ui](./django-allauth-vs-allauth-ui.png)\n\n\nUI templates for [django-allauth](https://github.com/pennersr/django-allauth)\nbuilt with Tailwind. https://django-allauth-ui.hodovi.ch.\n\ndjango-allauth is a great library, but the templates it provides out of the box\nare minimal html. I usually end up re-designing the login / logout / signup\npages for each new Django project. This library aims at providing good\ndefaults for new projects.\n\n## Table of contents\n\n* [Features](#features)\n* [Installation](#installation)\n* [Configuration](#configuration)\n* [Hacking on the project](#hacking-on-the-project)\n* [Contributors](#contributors)\n\n## Features\n\n- \ud83d\udcf1 Mobile-friendly design\n- \ud83d\udc84 [Configurable themes](https://daisyui.com/docs/themes/)\n- \ud83d\udd75\ufe0f Support for [Allauth User Sessions](https://docs.allauth.org/en/latest/usersessions/index.html)\n- \ud83d\udcf1Support for [Multi-Factor Authentication](https://docs.allauth.org/en/latest/mfa/index.html)\n- \ud83d\udde3\ufe0f Translations\n  - \ud83c\uddea\ud83c\uddf8 Spanish\n  - \ud83c\uddeb\ud83c\uddf7 French\n  - \ud83c\udde7\ud83c\uddf7 Portuguese\n  - \ud83c\uddf9\ud83c\uddf7 Turkish\n\n## Installation\n\n```\npip install django-allauth-ui\npip install django-widget-tweaks\npip install slippers\n```\n\ndjango-allauth-ui depends on [jazzband/django-widget-tweaks](https://github.com/jazzband/django-widget-tweaks)\nand [mixxorz/slippers](https://github.com/mixxorz/slippers) to render templates. Make\nsure to install both packages and add them to the INSTALLED_APPS.\n\nAdd django-allauth-ui **before** django-allauth in your INSTALLED_APPS. See\n[./tests/settings.py](./tests/settings.py) for an example.\n\n```python\nINSTALLED_APPS = [\n    \"allauth_ui\",\n    \"allauth\",\n    \"allauth.account\",\n    \"allauth.socialaccount\",\n    \"allauth.socialaccount.providers.github\",\n    \"widget_tweaks\",\n    \"slippers\",\n]\n```\n**Note**:\n\nWhen going to **production** you should run ```python manage.py collectstatic```\n\n## Configuration\n\nThe templates can be themed using Django settings. The theme value corresponds to [DaisyUI themes](https://daisyui.com/docs/themes/).\n\n```python\n# settings.py\nALLAUTH_UI_THEME = \"light\"\n```\n\n## Hacking on the project\n\n- Install direnv: https://direnv.net/docs/installation.html\n- Setup direnv: https://direnv.net/docs/hook.html\n\n```sh\n# Clone the repo\ngit clone git@github.com:danihodovic/django-allauth-ui.git\ncd django-allauth-ui.git\n\n# Active the virtual env\ndirenv allow\n\n# Install the dependencies\npip install --upgrade pip poetry\npoetry install\n\n# Install tailwind\nnpm install\n\n# Run the migrations\n./manage.py migrate\n\n# Add sample social providers\n./manage.py create_test_providers\n\n# Start the server\n./manage.py runserver_plus\n\n# Start the tailwind compilation process in another terminal\nnpm run-script build:watch\n```\n\nMake changes in allauth_ui/templates and open the browser at http://localhost:8000/accounts/login/.\n\nOnce you're done compile tailwind with `npm run-script build` and submit a pull-request \ud83c\udccf\n\n## Contributors\n<a href=\"https://github.com/danihodovic/django-allauth-ui/graphs/contributors\">\n  <img src=\"https://contrib.rocks/image?repo=danihodovic/django-allauth-ui\" />\n</a>\n\nMade with [contrib.rocks](https://contrib.rocks).\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": null,
    "version": "1.6.1",
    "project_urls": {
        "Homepage": "https://github.com/danihodovic/django-allauth-ui",
        "Repository": "https://github.com/danihodovic/django-allauth-ui"
    },
    "split_keywords": [
        "django",
        " allauth",
        " social-login",
        " auth"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "8dbcddc663d608f1ef5b87c644f53de8e510f843c6ffde40dc315770b20ee358",
                "md5": "1d20a4f6eca019d7ac8d243eef96627b",
                "sha256": "f4f8b5629c8839c4e5f26fc65642ad227fd3ed0465de2e45924a797cddaf4645"
            },
            "downloads": -1,
            "filename": "django_allauth_ui-1.6.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "1d20a4f6eca019d7ac8d243eef96627b",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 42610,
            "upload_time": "2025-02-15T22:08:36",
            "upload_time_iso_8601": "2025-02-15T22:08:36.253188Z",
            "url": "https://files.pythonhosted.org/packages/8d/bc/ddc663d608f1ef5b87c644f53de8e510f843c6ffde40dc315770b20ee358/django_allauth_ui-1.6.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "ba5e77fb367763c305b79a93f8c4bded0dfb2fb39b26df3b7c1d42e3e49d8225",
                "md5": "19690e4aff8194ad8dae09f2a0383c69",
                "sha256": "8a1b966cf6f78908d36a0973f6d84cfa6dbb93a55608b0625f6d644745180bcf"
            },
            "downloads": -1,
            "filename": "django_allauth_ui-1.6.1.tar.gz",
            "has_sig": false,
            "md5_digest": "19690e4aff8194ad8dae09f2a0383c69",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 38089,
            "upload_time": "2025-02-15T22:08:38",
            "upload_time_iso_8601": "2025-02-15T22:08:38.633761Z",
            "url": "https://files.pythonhosted.org/packages/ba/5e/77fb367763c305b79a93f8c4bded0dfb2fb39b26df3b7c1d42e3e49d8225/django_allauth_ui-1.6.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-02-15 22:08:38",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "danihodovic",
    "github_project": "django-allauth-ui",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "django-allauth-ui"
}
Dani Hodovic
Elapsed time: 2.67114s