# naveenthiran6955/full-stack-fastapi-template architecture

> Architecture diagram of the GitHub repository naveenthiran6955/full-stack-fastapi-template, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/naveenthiran6955/full-stack-fastapi-template
- Repository: https://github.com/naveenthiran6955/full-stack-fastapi-template

## Overview

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: [`backend/app/api/routes/users.py`](https://github.com/naveenthiran6955/full-stack-fastapi-template/blob/master/backend/app/api/routes/users.py) (User Endpoints), [`backend/app/api/routes/login.py`](https://github.com/naveenthiran6955/full-stack-fastapi-template/blob/master/backend/app/api/routes/login.py) (Login & Recovery), [`frontend/src/routes/_layout`](https://github.com/naveenthiran6955/full-stack-fastapi-template/tree/master/frontend/src/routes/_layout) (Dashboard Pages), [`backend/app/crud.py`](https://github.com/naveenthiran6955/full-stack-fastapi-template/blob/master/backend/app/crud.py) (CRUD Operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Frontend"]
  node_frontend_app["React App<br/>[main.tsx]"]
  node_route_tree["App Routes<br/>[routeTree.gen.ts]"]
  node_auth_pages["Login &amp; Signup<br/>[login.tsx]"]
  node_dashboard_pages["Dashboard Pages"]
  node_admin_ui["Admin UI"]
  node_item_ui["Item UI"]
  node_settings_ui["User Settings"]
  node_api_sdk["Generated API SDK<br/>[sdk.gen.ts]"]
  node_http_request["HTTP Request Core<br/>[request.ts]"]
end

subgraph group_api["Backend API"]
  node_api_server["FastAPI App<br/>[main.py]"]
  node_api_router["API Router<br/>[main.py]"]
  node_item_routes["Item Endpoints<br/>[items.py]"]
  node_user_routes["User Endpoints<br/>[users.py]"]
end

subgraph group_identity["Identity &amp; Email"]
  node_login_routes["Login &amp; Recovery<br/>[login.py]"]
  node_auth_deps["Auth Dependencies<br/>[deps.py]"]
  node_security["Token &amp; Password Security<br/>[security.py]"]
  node_email_utils["Email &amp; Recovery Utilities<br/>[utils.py]"]
end

subgraph group_data["Persistence"]
  node_crud["CRUD Operations<br/>[crud.py]"]
  node_models["User &amp; Item Models<br/>[models.py]"]
  node_db_session["Database Engine<br/>[db.py]"]
end

node_user(("User"))
node_postgres[("PostgreSQL")]
node_smtp["SMTP Service"]

node_user -->|"uses"| node_frontend_app
node_frontend_app -->|"loads routes"| node_route_tree
node_route_tree -->|"registers"| node_auth_pages
node_route_tree -->|"registers"| node_dashboard_pages
node_user -.->|"uses"| node_auth_pages
node_user -.->|"uses"| node_dashboard_pages
node_dashboard_pages -.->|"renders"| node_admin_ui
node_dashboard_pages -.->|"renders"| node_item_ui
node_dashboard_pages -.->|"renders"| node_settings_ui
node_auth_pages -.->|"calls"| node_api_sdk
node_admin_ui -.->|"calls"| node_api_sdk
node_item_ui -.->|"calls"| node_api_sdk
node_settings_ui -.->|"calls"| node_api_sdk
node_api_sdk -->|"dispatches"| node_http_request
node_http_request -.->|"sends HTTP requests"| node_api_server
node_api_server -->|"mounts"| node_api_router
node_api_router -->|"includes"| node_login_routes
node_api_router -->|"includes"| node_user_routes
node_api_router -->|"includes"| node_item_routes
node_login_routes -->|"authenticates users"| node_crud
node_login_routes -->|"creates access tokens"| node_security
node_login_routes -->|"requests recovery email"| node_email_utils
node_user_routes -->|"creates users"| node_crud
node_user_routes -->|"verifies passwords"| node_security
node_user_routes -->|"uses schemas"| node_models
node_item_routes -->|"uses schemas"| node_models
node_login_routes -->|"uses current-user dependency"| node_auth_deps
node_user_routes -->|"uses authorization dependencies"| node_auth_deps
node_auth_deps -->|"opens sessions"| node_db_session
node_auth_deps -->|"decodes tokens"| node_security
node_crud -->|"hashes passwords"| node_security
node_crud -->|"builds records"| node_models
node_db_session -->|"loads model metadata"| node_models
node_db_session -->|"seeds first user"| node_crud
node_db_session -->|"connects"| node_postgres
node_email_utils -.->|"sends mail"| node_smtp

click node_frontend_app "https://github.com/naveenthiran6955/full-stack-fastapi-template/blob/master/frontend/src/main.tsx"
click node_route_tree "https://github.com/naveenthiran6955/full-stack-fastapi-template/blob/master/frontend/src/routeTree.gen.ts"
click node_auth_pages "https://github.com/naveenthiran6955/full-stack-fastapi-template/blob/master/frontend/src/routes/login.tsx"
click node_dashboard_pages "https://github.com/naveenthiran6955/full-stack-fastapi-template/tree/master/frontend/src/routes/_layout"
click node_admin_ui "https://github.com/naveenthiran6955/full-stack-fastapi-template/tree/master/frontend/src/components/Admin"
click node_item_ui "https://github.com/naveenthiran6955/full-stack-fastapi-template/tree/master/frontend/src/components/Items"
click node_settings_ui "https://github.com/naveenthiran6955/full-stack-fastapi-template/tree/master/frontend/src/components/UserSettings"
click node_api_sdk "https://github.com/naveenthiran6955/full-stack-fastapi-template/blob/master/frontend/src/client/sdk.gen.ts"
click node_http_request "https://github.com/naveenthiran6955/full-stack-fastapi-template/blob/master/frontend/src/client/core/request.ts"
click node_api_server "https://github.com/naveenthiran6955/full-stack-fastapi-template/blob/master/backend/app/main.py"
click node_api_router "https://github.com/naveenthiran6955/full-stack-fastapi-template/blob/master/backend/app/api/main.py"
click node_item_routes "https://github.com/naveenthiran6955/full-stack-fastapi-template/blob/master/backend/app/api/routes/items.py"
click node_user_routes "https://github.com/naveenthiran6955/full-stack-fastapi-template/blob/master/backend/app/api/routes/users.py"
click node_login_routes "https://github.com/naveenthiran6955/full-stack-fastapi-template/blob/master/backend/app/api/routes/login.py"
click node_auth_deps "https://github.com/naveenthiran6955/full-stack-fastapi-template/blob/master/backend/app/api/deps.py"
click node_security "https://github.com/naveenthiran6955/full-stack-fastapi-template/blob/master/backend/app/core/security.py"
click node_email_utils "https://github.com/naveenthiran6955/full-stack-fastapi-template/blob/master/backend/app/utils.py"
click node_crud "https://github.com/naveenthiran6955/full-stack-fastapi-template/blob/master/backend/app/crud.py"
click node_models "https://github.com/naveenthiran6955/full-stack-fastapi-template/blob/master/backend/app/models.py"
click node_db_session "https://github.com/naveenthiran6955/full-stack-fastapi-template/blob/master/backend/app/core/db.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_frontend_app,node_route_tree,node_auth_pages,node_dashboard_pages,node_admin_ui,node_item_ui,node_settings_ui,node_api_sdk,node_http_request,node_user toneBlue
class node_api_server,node_api_router,node_item_routes,node_user_routes,node_postgres toneAmber
class node_login_routes,node_auth_deps,node_security,node_email_utils toneMint
class node_crud,node_models,node_db_session toneRose
class node_smtp toneIndigo
```

## Components

### Frontend

- [React App](https://github.com/naveenthiran6955/full-stack-fastapi-template/blob/master/frontend/src/main.tsx): `frontend/src/main.tsx`
- [App Routes](https://github.com/naveenthiran6955/full-stack-fastapi-template/blob/master/frontend/src/routeTree.gen.ts): `frontend/src/routeTree.gen.ts`
- [Login & Signup](https://github.com/naveenthiran6955/full-stack-fastapi-template/blob/master/frontend/src/routes/login.tsx): `frontend/src/routes/login.tsx`
- [Dashboard Pages](https://github.com/naveenthiran6955/full-stack-fastapi-template/tree/master/frontend/src/routes/_layout): `frontend/src/routes/_layout`
- [Admin UI](https://github.com/naveenthiran6955/full-stack-fastapi-template/tree/master/frontend/src/components/Admin): `frontend/src/components/Admin`
- [Item UI](https://github.com/naveenthiran6955/full-stack-fastapi-template/tree/master/frontend/src/components/Items): `frontend/src/components/Items`
- [User Settings](https://github.com/naveenthiran6955/full-stack-fastapi-template/tree/master/frontend/src/components/UserSettings): `frontend/src/components/UserSettings`
- [Generated API SDK](https://github.com/naveenthiran6955/full-stack-fastapi-template/blob/master/frontend/src/client/sdk.gen.ts): `frontend/src/client/sdk.gen.ts`
- [HTTP Request Core](https://github.com/naveenthiran6955/full-stack-fastapi-template/blob/master/frontend/src/client/core/request.ts): `frontend/src/client/core/request.ts`

### Backend API

- [FastAPI App](https://github.com/naveenthiran6955/full-stack-fastapi-template/blob/master/backend/app/main.py): `backend/app/main.py`
- [API Router](https://github.com/naveenthiran6955/full-stack-fastapi-template/blob/master/backend/app/api/main.py): `backend/app/api/main.py`
- [Item Endpoints](https://github.com/naveenthiran6955/full-stack-fastapi-template/blob/master/backend/app/api/routes/items.py): `backend/app/api/routes/items.py`
- [User Endpoints](https://github.com/naveenthiran6955/full-stack-fastapi-template/blob/master/backend/app/api/routes/users.py): `backend/app/api/routes/users.py`

### Identity & Email

- [Login & Recovery](https://github.com/naveenthiran6955/full-stack-fastapi-template/blob/master/backend/app/api/routes/login.py): `backend/app/api/routes/login.py`
- [Auth Dependencies](https://github.com/naveenthiran6955/full-stack-fastapi-template/blob/master/backend/app/api/deps.py): `backend/app/api/deps.py`
- [Token & Password Security](https://github.com/naveenthiran6955/full-stack-fastapi-template/blob/master/backend/app/core/security.py): `backend/app/core/security.py`
- [Email & Recovery Utilities](https://github.com/naveenthiran6955/full-stack-fastapi-template/blob/master/backend/app/utils.py): `backend/app/utils.py`

### Persistence

- [CRUD Operations](https://github.com/naveenthiran6955/full-stack-fastapi-template/blob/master/backend/app/crud.py): `backend/app/crud.py`
- [User & Item Models](https://github.com/naveenthiran6955/full-stack-fastapi-template/blob/master/backend/app/models.py): `backend/app/models.py`
- [Database Engine](https://github.com/naveenthiran6955/full-stack-fastapi-template/blob/master/backend/app/core/db.py): `backend/app/core/db.py`

### Other components

- **User**
- **PostgreSQL**
- **SMTP Service**

## Connections

- User → React App: uses
- React App → App Routes: loads routes (evidence: `frontend/src/main.tsx`)
- App Routes → Login & Signup: registers (evidence: `frontend/src/routeTree.gen.ts`)
- App Routes → Dashboard Pages: registers (evidence: `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 (evidence: `frontend/src/client/sdk.gen.ts`)
- HTTP Request Core → FastAPI App: sends HTTP requests
- FastAPI App → API Router: mounts (evidence: `backend/app/main.py`)
- API Router → Login & Recovery: includes (evidence: `backend/app/api/main.py`)
- API Router → User Endpoints: includes (evidence: `backend/app/api/main.py`)
- API Router → Item Endpoints: includes (evidence: `backend/app/api/main.py`)
- Login & Recovery → CRUD Operations: authenticates users (evidence: `backend/app/api/routes/login.py`)
- Login & Recovery → Token & Password Security: creates access tokens (evidence: `backend/app/api/routes/login.py`)
- Login & Recovery → Email & Recovery Utilities: requests recovery email (evidence: `backend/app/api/routes/login.py`)
- User Endpoints → CRUD Operations: creates users (evidence: `backend/app/api/routes/users.py`)
- User Endpoints → Token & Password Security: verifies passwords (evidence: `backend/app/api/routes/users.py`)
- User Endpoints → User & Item Models: uses schemas (evidence: `backend/app/api/routes/users.py`)
- Item Endpoints → User & Item Models: uses schemas (evidence: `backend/app/api/routes/items.py`)
- Login & Recovery → Auth Dependencies: uses current-user dependency (evidence: `backend/app/api/routes/login.py`)
- User Endpoints → Auth Dependencies: uses authorization dependencies (evidence: `backend/app/api/routes/users.py`)
- Auth Dependencies → Database Engine: opens sessions (evidence: `backend/app/api/deps.py`)
- Auth Dependencies → Token & Password Security: decodes tokens (evidence: `backend/app/api/deps.py`)
- CRUD Operations → Token & Password Security: hashes passwords (evidence: `backend/app/crud.py`)
- CRUD Operations → User & Item Models: builds records (evidence: `backend/app/crud.py`)
- Database Engine → User & Item Models: loads model metadata (evidence: `backend/app/core/db.py`)
- Database Engine → CRUD Operations: seeds first user (evidence: `backend/app/core/db.py`)
- Database Engine → PostgreSQL: connects (evidence: `backend/app/core/db.py`)
- Email & Recovery Utilities → SMTP Service: sends mail
