reflex-django 4.0.1

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 · 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 AppState read self.request.user like a Django view.

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 every Reflex event.

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 · Auth · Config

---

Commands

reflex run
reflex export
reflex django migrate
reflex django createsuperuser

---

Requirements

	Version
reflex-django	4.0+
Python	3.12+
Django	6.0+
Reflex	0.9.4+

---

Author: Mohannad Irshedat · Docs