How naveenthiran6955/full-stack-fastapi-template works
This is a full-stack account and item-management application: users sign up or log in, receive JWT-backed access, and manage their profile and items; administrators manage users. The frontend provides dashboard, item, admin, and settings areas through a generated API client. The backend exposes those API domains, applies authentication and authorization, and persists user/item records. Password recovery and email delivery are documented capabilities. Several frontend route and UI implementations are unsampled, so their links to the client are shown as unverified rather than asserted.
Main entry points: users.py User Endpoints · login.py Login & Recovery · _layout Dashboard Pages · crud.py CRUD Operations
Components 23
Frontend
- React App
frontend/src/main.tsx - App Routes
frontend/src/routeTree.gen.ts - Login & Signup
frontend/src/routes/login.tsx - Dashboard Pages
frontend/src/routes/_layout - Admin UI
frontend/src/components/Admin - Item UI
frontend/src/components/Items - User Settings
frontend/src/components/UserSettings - Generated API SDK
frontend/src/client/sdk.gen.ts - HTTP Request Core
frontend/src/client/core/request.ts
Backend API
- FastAPI App
backend/app/main.py - API Router
backend/app/api/main.py - Item Endpoints
backend/app/api/routes/items.py - User Endpoints
backend/app/api/routes/users.py
Identity & Email
- Login & Recovery
backend/app/api/routes/login.py - Auth Dependencies
backend/app/api/deps.py - Token & Password Security
backend/app/core/security.py - Email & Recovery Utilities
backend/app/utils.py
Persistence
- CRUD Operations
backend/app/crud.py - User & Item Models
backend/app/models.py - Database Engine
backend/app/core/db.py
Other components
- User
- PostgreSQL
- SMTP Service
Connections 36
- User → React App: uses
- React App → App Routes: loads routes
frontend/src/main.tsx - App Routes → Login & Signup: registers
frontend/src/routeTree.gen.ts - App Routes → Dashboard Pages: registers
frontend/src/routeTree.gen.ts - User → Login & Signup: uses
- User → Dashboard Pages: uses
- Dashboard Pages → Admin UI: renders
- Dashboard Pages → Item UI: renders
- Dashboard Pages → User Settings: renders
- Login & Signup → Generated API SDK: calls
- Admin UI → Generated API SDK: calls
- Item UI → Generated API SDK: calls
- User Settings → Generated API SDK: calls
- Generated API SDK → HTTP Request Core: dispatches
frontend/src/client/sdk.gen.ts - HTTP Request Core → FastAPI App: sends HTTP requests
- FastAPI App → API Router: mounts
backend/app/main.py - API Router → Login & Recovery: includes
backend/app/api/main.py - API Router → User Endpoints: includes
backend/app/api/main.py - API Router → Item Endpoints: includes
backend/app/api/main.py - Login & Recovery → CRUD Operations: authenticates users
backend/app/api/routes/login.py - Login & Recovery → Token & Password Security: creates access tokens
backend/app/api/routes/login.py - Login & Recovery → Email & Recovery Utilities: requests recovery email
backend/app/api/routes/login.py - User Endpoints → CRUD Operations: creates users
backend/app/api/routes/users.py - User Endpoints → Token & Password Security: verifies passwords
backend/app/api/routes/users.py - User Endpoints → User & Item Models: uses schemas
backend/app/api/routes/users.py - Item Endpoints → User & Item Models: uses schemas
backend/app/api/routes/items.py - Login & Recovery → Auth Dependencies: uses current-user dependency
backend/app/api/routes/login.py - User Endpoints → Auth Dependencies: uses authorization dependencies
backend/app/api/routes/users.py - Auth Dependencies → Database Engine: opens sessions
backend/app/api/deps.py - Auth Dependencies → Token & Password Security: decodes tokens
backend/app/api/deps.py - CRUD Operations → Token & Password Security: hashes passwords
backend/app/crud.py - CRUD Operations → User & Item Models: builds records
backend/app/crud.py - Database Engine → User & Item Models: loads model metadata
backend/app/core/db.py - Database Engine → CRUD Operations: seeds first user
backend/app/core/db.py - Database Engine → PostgreSQL: connects
backend/app/core/db.py - Email & Recovery Utilities → SMTP Service: sends mail