django-auth 🔐

This project is a simple Django-based authentication system. It includes features for user registration, login, profile update, and profile deletion. The application is built using Django 5.1.5 and uses SQLite3 as the database. The project also includes authentication-related icons from Flaticon.

Features 🚀

• User Registration (Sign up): Allows new users to create an account.
• User Login (Sign in): Authenticated users can sign in.
• Profile Update: Users can update their profile information, such as bio and profile picture.
• Profile Deletion: Users can delete their profile from the system.
• User Logout: Authenticated users can log out.

Tech Stack 🛠️

• Backend: Django 5.1.5
• Database: SQLite3
• Authentication: Custom user model based on AbstractUser
• File Storage: Image uploads (using Pillow)

Setup and Installation ⚙️

Clone the repository

git clone https://github.com/whdev36/django-auth.git
cd django-auth

Install dependencies

Create a virtual environment and activate it:

# On Windows use `Set-ExecutionPolicy RemoteSigned -Scope CurrentUser`
python3 -m venv venv
source venv/bin/activate  # On Windows use `venv\Scripts\activate`

Install required libraries:

pip install -r requirements.txt

Apply database migrations

Run the following command to set up the database:

python manage.py migrate

Create a superuser

To create an admin user to manage the application:

python manage.py createsuperuser

Run the development server

Start the Django development server:

python manage.py runserver

You can now access the application at http://127.0.0.1:8000/.

Pages 📄

• / - Home/Profile page
• /login/ - Sign in page
• /register/ - Sign up page
• /logout/ - Sign out page
• /update/ - Update profile page
• /delete/ - Delete profile page

Dependencies 📦

asgiref==3.8.1
Django==5.1.5
pillow==11.1.0
sqlparse==0.5.3
tzdata==2024.2
whitenoise==6.8.2

Icons 🎨

Icons used in this project are from Flaticon:

• Authentication icons by Triangle Squad
• Biometric icons by meaicon

License 📝

This project is licensed under the MIT License - see the LICENSE file for details.

Shields 🛡️

Contributing 🤝

1. Fork the repository
2. Create your feature branch (git checkout -b feature/your-feature)
3. Commit your changes (git commit -m 'Add new feature')
4. Push to the branch (git push origin feature/your-feature)
5. Open a Pull Request

Acknowledgements 🙏

Thanks to Flaticon for providing the icons used in this project.

---

Happy coding! 🚀