AuthStack 🔐

AuthStack is a modern, full-featured Django authentication system with a built-in user balance system and fully customizable UI. It provides a secure, ready-to-use foundation for web applications requiring user accounts, email verification, password recovery, and virtual currency/credit management.

✨ Features

🔐 Authentication

• User registration & login with email notifications
• Session management & secure logout
• Profile editing with avatar upload

💰 Balance System

• Each user has a personal balance (credits/points/virtual currency)

🎨 UI & Customization

• Modern glassmorphism design
• Fully responsive (mobile, tablet, desktop)
• Easy to customize CSS variables
• Animated transitions & micro-interactions
• Separate CSS and JS files for clean code

🔧 Technical Stack

• Backend: Django (Python)
• Frontend: HTML5, CSS3, JavaScript (Vanilla)
• Database: SQLite (default), supports PostgreSQL/MySQL
• Authentication: Django's built-in auth system + custom enhancements
• File Upload: Profile picture handling

🚀 Quick Start

Prerequisites

• Python 3.8 or higher
• Git

Installation

1. Clone the repository

   git clone https://github.com/CodeWithMSami/AuthStack.git
   cd AuthStack

2. Create a virtual environment

   python -m venv venv
   # On Windows:
   venv\Scripts\activate
   # On macOS/Linux:
   source venv/bin/activate

3. Install dependencies

   pip install -r requirements.txt

4. Run migrations

   python manage.py makemigrations
   python manage.py migrate

5. Create a superuser (admin)

   python manage.py createsuperuser

6. Start the development server

   python manage.py runserver

7. Open your browser and navigate to http://127.0.0.1:8000