Simple Next.j 14 boilerplate that uses FastAPI as the API backend.
This is a hybrid Next.js 14 + Python template. One great use case of this is to write Next.js apps that use Python AI libraries on the backend, while still having the benefits of Next.js Route Handlers and Server Side Rendering.
The Python/FastAPI server is mapped into to Next.js app under /api/.
This is implemented using next.config.js rewrites to map any request to /api/py/:path* to the FastAPI API, which is hosted in the /api folder.
Also, the app/api routes are available on the same domain, so you can use NextJs Route Handlers and make requests to /api/....
On localhost, the rewrite will be made to the 127.0.0.1:8000 port, which is where the FastAPI server is running.
In production, both Next.js and FastAPI run in a single container orchestrated by Kubernetes.
- Docker
- Kubernetes
- Make
You can create a .env file by copying the .env.example file and filling in the values.
Install node and python dependencies:
make installYou can clone & create this repo with the following command
make devBuild app locally:
make buildmake docker-buildmake docker-runmake deploymake releaseClone this repo, create .env file, install and run:
make install
make devOpen http://localhost:3000 with your browser to see the result.
The FastApi server will be running on http://127.0.0.1:8000 – feel free to change the port in package.json (you'll also need to update it in next.config.js).
To learn more about Next.js, take a look at the following resources:
- Next.js Documentation - learn about Next.js features and API.
- Learn Next.js - an interactive Next.js tutorial.
- FastAPI Documentation - learn about FastAPI features and API.
You can check out the Next.js GitHub repository - your feedback and contributions are welcome!