Next.js FastAPI Starter
Simple Next.js boilerplate that uses FastAPI as the API backend.
Introduction
This is a hybrid Next.js + Python app that uses Next.js as the frontend and FastAPI as the API backend. One great use case of this is to write Next.js apps that use Python AI libraries on the backend.
How It Works
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/:path* to the FastAPI API, which is hosted in the /api folder.
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, the FastAPI server is hosted as Python serverless functions on Vercel.
Demo
https://nextjs-fastapi-starter.vercel.app/
Deploy Your Own
You can clone & deploy it to Vercel with one click:
Developing Locally
You can clone & create this repo with the following command
npx create-next-app nextjs-fastapi --example "https://github.com/digitros/nextjs-fastapi"Getting Started
First, install the dependencies:
npm install
# or
yarn
# or
pnpm installThen, run the development server:
npm run dev
# or
yarn dev
# or
pnpm 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).
Learn More
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!