Skip to content

README.md

Latest commit

 

History

History
60 lines (46 loc) · 2.01 KB

README.md

File metadata and controls

60 lines (46 loc) · 2.01 KB

🔐 FastAPI Auth & User Management

One-file FastAPI authentication system with JWT tokens, user management, admin panel, and built-in frontend.

One Click Deploy

Deploy on Railway

Quick Start (Local)

pip install -r requirements.txt
python main.py
# Open http://localhost:8080
Variable Default Description
SECRET_KEY auto-generated JWT signing key (set for persistence across redeploys)
ACCESS_TOKEN_EXPIRE_MINUTES 30 Access token lifetime
REFRESH_TOKEN_EXPIRE_DAYS 7 Refresh token lifetime
APP_NAME FastAPI Auth Shown in UI
  1. To create the one-click deploy template: Railway Dashboard → Project → Settings → Generate Template

Features

  • Register / Login (email or username) / Logout
  • JWT access + refresh tokens with rotation
  • Token revocation (logout invalidates tokens)
  • Profile view & edit, password change, account deletion
  • Admin panel: list users, toggle active/admin status
  • Auto-creates tables on startup
  • SQLite locally, PostgreSQL on Railway
  • Built-in frontend + Swagger UI at /docs

API Endpoints

POST   /api/auth/register          → Create account, get tokens
POST   /api/auth/login             → Login, get tokens
POST   /api/auth/refresh           → Rotate refresh token
POST   /api/auth/logout            → Revoke token
GET    /api/users/me               → Get profile
PATCH  /api/users/me               → Update profile
POST   /api/users/me/change-password
DELETE /api/users/me               → Delete account
GET    /api/admin/users            → List all users (admin)
PATCH  /api/admin/users/{id}/toggle-active
PATCH  /api/admin/users/{id}/toggle-admin
GET    /api/health

Making First Admin

Register your first user via the UI, then connect to the Railway PostgreSQL and run:

UPDATE users SET is_admin = true WHERE id = 1;