LinkHub Pro | Abderraouf Atsamnia

📋 Project Overview

LinkHub Pro is a full-stack SaaS web application inspired by Linktree. It gives every user a clean public page at /username where they can showcase all their important links — portfolio, GitHub, LinkedIn, social media — from a single shareable URL.

Built entirely from scratch with Flask and deployed live on Render with a Neon PostgreSQL database. The project covers the full SaaS lifecycle: authentication, user settings, analytics, file uploads, and production deployment.

✨ Key Features

👤User authentication — register, login, logout with CSRF protection and rate limiting
🔗Unlimited links — add, delete, and reorder with drag & drop (Sortable.js)
📊Click analytics — every link click is tracked with a daily bar chart
📱QR code generation — download a PNG QR code for your profile page
📋Copy link button — one-click copy of your profile URL
📷Avatar upload — secure file upload with size and type validation
🎨4 themes — Light, Dark, Neon, Professional — saved per user in the database
🌐Custom domain — map your own domain to your profile page
🔒Remember me — persistent 30-day login sessions

🏗️ Architecture

linkhub-pro/
  backend/
    app.py          ← Flask app factory
    db.py           ← SQLAlchemy instance
    models.py       ← User, Link, Click models
    routes/
      auth.py       ← Register / Login / Logout
      dashboard.py ← Link CRUD + profile + QR
      public.py     ← Public profile + click tracking
      analytics.py ← Analytics JSON endpoint
  templates/       ← Jinja2 HTML templates
  static/          ← CSS, JS, avatars
  migrations/      ← Flask-Migrate / Alembic