UXDL Docs

Backend

Node.js (Express + TypeScript) and Python (FastAPI) — API patterns, data layer, cloud services, and deployment.

Overview

Backend Overview

Languages, when to use Node vs Python, databases, ORMs, and shared conventions.

Node.js · Express

Setup & Installation

Bootstrap Express + TypeScript, configure env, and run locally.

Folder Structure

Standard Express layout — routes, controllers, services, and middleware.

API Authentication

Bearer tokens, Cognito validation, scopes, and rate limits.

Python · FastAPI

Setup & Installation

Bootstrap FastAPI with uv, configure env, and run with Uvicorn.

Folder Structure

Standard FastAPI layout — routers, dependencies, services, and schemas.

API Authentication

Cognito JWT validation, OAuth2 scopes, and rate limiting.

Data Layer

PostgreSQL + Sequelize

Node — Sequelize models, migrations, associations, and seeding.

PostgreSQL + Drizzle

Node — Drizzle schema, type-safe queries, and migration workflow.

PostgreSQL + SQLAlchemy

Python — SQLAlchemy 2.0 models, Alembic migrations, and async sessions.

MongoDB

Mongoose (Node) and Motor/Beanie (Python) — models and document patterns.

Supabase

Supabase client, Postgres via Supabase, RLS, and realtime.

Realtime

Socket.io

WebSocket server, rooms, auth, and client integration.

Cloud Services

AWS S3

Object storage, presigned uploads, and file access patterns.

Push — FCM

Firebase Cloud Messaging for web, iOS, and Android push notifications.

Email

Transactional email via AWS SES, SendGrid, and Brevo.

Deployment

Docker

Multi-stage Dockerfile, compose for local, and image publishing.

AWS ECS

ECS task definitions, services, rolling deploys, and rollback.

Start with Backend Overview