Django Next.js
Django + Next.js integration
From a comment on StackOverflow:
Run 2 ports on the same server. One for django (public facing) and one for Next.js (internal). Let django handle all web requests. For each request, query Next.js from django view to get HTML response. Return that exact HTML response from django view.
Installation
-
Install the latest version from PyPI.
pip install django-nextjs
-
Add
django_nextjstoINSTALLED_APPS. -
In Development Environment:
-
If you're using django channels, add
NextJSProxyHttpConsumerandNextJSProxyWebsocketConsumertoasgi.py:import os from django.core.asgi import get_asgi_application from django.urls import re_path os.environ.setdefault("DJANGO_SETTINGS_MODULE", "myproject.settings") django_asgi_app = get_asgi_application() from channels.auth import AuthMiddlewareStack from channels.routing import ProtocolTypeRouter, URLRouter from django_nextjs.proxy import NextJSProxyHttpConsumer, NextJSProxyWebsocketConsumer from django.conf import settings http_routes = [...] websocket_routers = [...] if settings.DEBUG: http_routes.insert(0, re_path(r"^(?:_next|__next|next).*", NextJSProxyHttpConsumer.as_asgi())) websocket_routers.insert(0, path("_next/webpack-hmr", NextJSProxyWebsocketConsumer.as_asgi())) application = ProtocolTypeRouter( { # Django's ASGI application to handle traditional HTTP and websocket requests. "http": URLRouter(http_routes), "websocket": AuthMiddlewareStack(URLRouter(websocket_routers)), # ... } )
-
Otherwise, add the following to the beginning of
urls.py:path("", include("django_nextjs.urls"))
-
-
In Production:
-
Use a reverse proxy like nginx:
URL Action /_next/static/...Serve NEXTJS_PATH/.next/staticdirectory/_next/...Proxy to http://localhost:3000/next/...Serve NEXTJS_PATH/public/nextdirectoryPass
x-real-ipheader when proxying/_next/:location /_next/ { proxy_set_header x-real-ip $remote_addr; proxy_pass http://127.0.0.1:3000; }
-
Usage
Start Next.js server:
# Development:
$ npm run dev
# Production:
$ npm run build
$ npm run start
Develop your pages in Next.js. Write a django URL and view for each page like this:
# If you're using django channels
from django.http import HttpResponse
from django_nextjs.render import render_nextjs_page_async
async def jobs(request):
return await render_nextjs_page_async(request)
# If you're not using django channels
from django.http import HttpResponse
from django_nextjs.render import render_nextjs_page_sync
def jobs(request):
return render_nextjs_page_sync(request)
Customizing Document
If you want to customize the HTML document (e.g. add header or footer), read this section.
You need to customize Next's document:
- Add
id="__django_nextjs_body"as the first attribute of<body>element. - Add
<div id="__django_nextjs_body_begin" />as the first element inside<body>. - Add
<div id="__django_nextjs_body_end" />as the last element inside<body>.
import Document, { Html, Head, Main, NextScript } from "next/document";
// https://nextjs.org/docs/advanced-features/custom-document
class MyDocument extends Document {
render() {
return (
<Html>
<Head />
<body id="__django_nextjs_body" dir="rtl">
<div id="__django_nextjs_body_begin" />
<Main />
<NextScript />
<div id="__django_nextjs_body_end" />
</body>
</Html>
);
}
}
export default MyDocument;
Write a django template that extends django_nextjs/document_base.html:
{% extends "django_nextjs/document_base.html" %}
{% block head %}
... the content you want to add to the beginning of <head> tag ...
{{ block.super }}
... the content you want to add to the end of <head> tag ...
{% endblock %}
{% block body %}
... the content you want to add to the beginning of <body> tag ...
{{ block.super }}
... the content you want to add to the end of <body> tag ...
{% endblock %}
Pass the template name to render_nextjs_page_async or render_nextjs_page_sync:
# If you're using django channels
async def jobs(request):
return await render_nextjs_page_async(request, "path/to/template.html")
# If you're not using django channels
def jobs(request):
return render_nextjs_page_sync(request, "path/to/template.html")
Notes
- If you want to add a file to
publicdirectory of Next.js, that file should be inpublic/nextsubdirectory to work correctly. - If you're using django channels, make sure all your middlewares are async-capable.
Settings
Default settings:
NEXTJS_SETTINGS = {
"nextjs_server_url": "http://127.0.0.1:3000",
}
nextjs_server_url
The URL of Next.js server (started by npm run dev or npm run start)
Development
- Install development dependencies in your virtualenv with
pip install -e '.[dev]' - Install pre-commit hooks using
pre-commit install.
49 Dec 30, 2022
621 Dec 30, 2022
5 Jan 04, 2023
4 Feb 17, 2022
408 Jan 06, 2023
7 Oct 06, 2021
2.3k Jan 06, 2023
557 Oct 19, 2022
5 May 12, 2022
940 Jan 03, 2023
152 Apr 03, 2022
487 Dec 06, 2022
10.4k Jan 03, 2023
33 Dec 22, 2022
1 Sep 28, 2021
361 Dec 22, 2022
26 Dec 09, 2022
4 Jan 15, 2022
15 Aug 30, 2022
12 Jun 04, 2022