lambda_flask

🚀 Flask Auth System

A secure Flask web application built to handle real-world authentication flows — not just login forms, but verified users, protected routes, and attack resistance.

This project focuses on doing the basics correctly, not just making them work.

---

⚡ Features

• 🔐 User Registration & Login
• 📧 Email Verification System
• 🔑 Secure Password Hashing
• 🚫 Rate Limiting (anti brute-force)
• 👤 Session Management (Flask-Login)
• 🛡️ Protected Dashboard
• 🧼 Input Validation

---

🧱 Tech Stack

Backend

• Python
• Flask
• Flask-Login
• Flask-SQLAlchemy
• Flask-Mail
• Flask-Limiter
• itsdangerous

Database

• SQLite

Frontend

• HTML / CSS / JavaScript

---

⚙️ Setup

1. Clone the repository

git clone https://github.com/optimuxprime8089856470/lambda_flask.git
cd lambda_flask

2. Create virtual environment

python -m venv venv

Activate it:

Windows

venv\Scripts\activate

Linux / macOS

source venv/bin/activate

---

3. Install dependencies

pip install -r requirements.txt
or install the packages manually

---

4. Configure environment variables

Create a .env file in the lambda configration env variables :

SECRET_KEY=your_secret_key
MAIL_USERNAME=your_email@gmail.com
MAIL_PASSWORD=your_app_password

if the gmail doesnt work 
use trapmail (only for testing)
repalce the gmail credentials with trapmail credentials

⚠️ Never upload .env to GitHub

---

5. Run the application

python app.py

Open:

http://127.0.0.1:5000/

---

🧪 Workflow

1. Register account
2. Receive verification email
3. Activate account
4. Login
5. Access dashboard

---

🔐 Security

• Password hashing (Werkzeug)
• Token-based email verification
• Rate limiting on login
• Session protection
• Environment variable handling

---

📸 Preview

---

🚧 Future Improvements

• Password reset system
• OAuth (Google login)
• Deployment (Render / VPS)
• Better UI/UX

---

👨‍💻 Author

Muhammed Darwish 🔗 https://github.com/optimuxprime8089856470

---

⭐ Note

This project proves you understand how authentication actually works.

If you extend this → you’re improving. If you stop here → you’re still basic.

HOME PAGE

LOGIN PAGE

DASHBOARD PAGE

Register pagge