Uploads and media

Reflex file uploads work with Django sessions. The bridge patches Reflex's /_upload handler so upload events carry cookies and routing metadata from the browser.

No extra wiring in shop/shop.py. Use Reflex upload components as documented in Reflex:

rx.upload(id="file_upload", on_drop=MyState.handle_upload)

Handlers run with bridge context, so self.request.user and session data are available on AppState.

Bridge tier

Upload events are never resolved below auth_only. Even if global bridge mode is none or a custom resolver returns none, upload requests are raised to auth_only so session/auth middleware can identify the user.

Use AppState for handlers that need the Django request:

class UploadState(AppState):
    @rx.event
    async def handle_upload(self, files: list[rx.UploadFile]):
        user = self.request.user
        ...

Dev media files

Serve uploaded files in DEBUG:

from django.conf import settings
from django.conf.urls.static import static
from django.contrib import admin
from django.urls import path

urlpatterns = [path("admin/", admin.site.urls)]

if settings.DEBUG:
    urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

Production

Do not serve MEDIA_ROOT through Django in production. Use object storage or nginx. Route /_upload and /_event to Reflex when using a split backend. See Deploy.

For large uploads, set body-size limits and timeouts on your edge proxy. The example nginx config routes /_upload to the Reflex backend.

Next: CLI