wrap-existing-django-in-electron

To wrap a Django web application into a desktop application, you can use an Electron shell with a bundled Python runtime. This approach packages your server-rendered Django app to run locally while preserving existing URLs, migrations, and seed data.

Yes, you can bundle a packaged Python runtime within an Electron shell to execute a Django project locally. This configuration supports flat settings files and packaged static/media serving to ensure the application functions correctly in a desktop environment.

To secure communication between an Electron shell and a local Django backend, you can enforce a minimal boundary by starting Django on 127.0.0.1 with a random port and injecting a per-session DESKTOP_DJANGO_AUTH_TOKEN header for exact-origin requests.

Wrapping Django in an Electron shell preserves existing authentication, seed data, URLs, and database migrations. The integration targets server-rendered Django apps and includes a small desktop auto-auth guard to maintain existing security workflows.

The best way to implement a health check for a Django desktop application is to implement a /health/ readiness endpoint. This allows the Electron shell to verify the local Django server has fully started before attempting to load the application interface.

To configure Django settings for a packaged desktop runtime, split your configuration into base_settings.py and packaged_settings.py. This flat settings split ensures static serving and media handling are correctly configured for the bundled runtime environment.