LinkShort — URL Shortener

URL shortener with JWT auth, click tracking, and dark UI. Full REST API + React SPA.

Features

• JWT authentication — register, login, token-based API access
• One-click shortening — paste URL, get short code
• Click tracking — each redirect increments counter
• Dashboard — manage URLs: copy, delete, stats
• Copy to clipboard — one-click copy
• Dark UI — professional dark theme, responsive
• REST API — Swagger docs at /docs
• SQLite — zero-config persistence

Tech Stack

Quick Start

git clone https://github.com/bartoszosiej/FastAPI-url.git
cd FastAPI-url
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload

Open http://localhost:8000

Build Frontend

cd frontend
npm install
npm run build
rm -rf ../backend/static
mkdir -p ../backend/static
cp -r dist/* ../backend/static/

API

Deploy

# Cloudflare Tunnel (free, no account)
cloudflared tunnel --url http://localhost:8000

Testing

pytest tests/ -v

License

MIT

🌐 Ecosystem

This project is part of the Bartosz Web Portfolio ecosystem.