reflex-django 4.0.2

Run a Django backend (Django ORM, Django Admin) alongside a Reflex app.

reflex-django

Keep Django. Get a reactive UI in Python. One command, shared cookies, native Reflex dev.

Documentation · LLM guide · GitHub · PyPI

---

What is reflex-django?

reflex-django is a Reflex plugin that runs your Django project and Reflex UI together. You keep Django for models, admin, auth, and APIs. You build the frontend in Python with Reflex components and state.

One dev command (reflex run) starts both sides. Sessions and cookies are shared, so a user logged in through Django is logged in on Reflex pages. Event handlers on Django-aware state read self.request.user like a Django view when bridge is enabled and the resolved tier binds request context.

The plugin wires four pieces automatically (embed, mount, proxy, bridge). Set profile: "integrated" in rxconfig.py and you get port 3000 dev, SPA routing, and Django middleware on bridge-bound Reflex events.

Install

uv add reflex-django

Or with pip (you also need Django and Reflex):

pip install reflex-django django reflex

New project with uv:

uv add django reflex reflex-django

Quick start

rxconfig.py:

import reflex as rx
from reflex_django.plugins import ReflexDjangoPlugin

config = rx.Config(
    app_name="shop",
    plugins=[
        ReflexDjangoPlugin(config={
            "settings_module": "config.settings",
            "profile": "integrated",
        }),
    ],
)

Then:

1. Add reflex_django to INSTALLED_APPS and put AsyncStreamingMiddleware last in MIDDLEWARE (full setup)
2. Create shop/shop.py with app = rx.App() and app.add_page(...) (pages and state)
3. Run reflex django migrate and reflex run
4. Open http://localhost:3000/

Learn each integration piece step by step →

API guides: Serializers · Model state · Forms/FieldSpec · Live updates · Devtools · Auth · Security · Config

---

Commands

reflex run
reflex export
reflex django migrate
reflex django makemigrations
reflex django createsuperuser
reflex django scaffold shop.Product --output shop/product_views.py

---

Requirements

	Version
reflex-django	4.0+
Python	3.12+
Django	6.0+
Reflex	>=0.9.4,<1.0

---

Author: Mohannad Irshedat · Docs