🌊 Beach Auth

Modern Full-Stack User Authentication System with FastAPI, JWT & Docker

A production-style authentication platform built with Python FastAPI, MongoDB, secure JWT sessions, email verification, and containerized deployment.

---

⚡ Overview

Beach Auth is a complete user authentication web application engineered to demonstrate modern account management architecture with:

• secure user registration
• email verification flow
• JWT-based login sessions
• role-based protected routes
• Dockerized deployment support

It combines backend engineering, UI integration, and secure session handling in one portfolio-ready project.

---

🚀 Core Features

✅ User signup with password hashing
✅ Email verification token system
✅ JWT login/logout workflow
✅ HttpOnly cookie session handling
✅ Role-based admin access
✅ Protected dashboard routes
✅ MongoDB integration
✅ Docker + Mongo Express support

---

🛡 Security Highlights

Layer	Implementation
Password Protection	bcrypt hashing
Session Management	signed JWT tokens
Cookie Security	HttpOnly cookies
Route Authorization	middleware protection
Account Validation	email verification
Role Control	admin/user separation

---

🧠 Technology Stack

• Python 3.11
• FastAPI
• MongoDB + Motor
• PyJWT
• Passlib Bcrypt
• Jinja2 Templates
• Docker / Docker Compose

---

🖥 Quick Start

docker compose up --build

Application:

http://localhost:8000

Mongo Express:

http://localhost:8081

---

📂 Project Structure

beach-auth/
├── app/
├── middleware/
├── models/
├── routes/
├── templates/
├── static/
├── Dockerfile
├── docker-compose.yml
└── README.md

---

🎯 Practical Applications

• SaaS authentication boilerplate
• Admin dashboard starter template
• JWT learning project
• Secure login architecture demo
• Full stack deployment portfolio project

---

📌 Why This Repo Matters

This repository demonstrates that the project is not just a frontend login form, but a complete authentication pipeline involving:

• backend route engineering
• token lifecycle management
• user verification
• session protection
• deployment readiness

which makes it highly relevant for backend and cybersecurity portfolios.

---

🔮 Planned Enhancements

• password reset workflow
• OAuth social login
• audit activity logs
• account lockout policy
• cloud deployment

---

Secure Sessions. Clean Backend. Deployable Authentication.