fastapi-vue
Runtime helpers for FastAPI + Vite/Vue projects.
Overview
This package provides:
fastapi_vue.Frontend: serves built SPA assets (with SPA support, caching, and optional zstd)fastapi_vue.server.run: a small Uvicorn runner with convenientlistenendpoint parsing
Quickstart
Serve built frontend assets from frontend-build/:
from pathlib import Path
from contextlib import asynccontextmanager
from fastapi import FastAPI
from fastapi_vue import Frontend
frontend = Frontend(Path(__file__).with_name("frontend-build"), spa=True)
@asynccontextmanager
async def lifespan(app: FastAPI):
await frontend.load()
yield
app = FastAPI(lifespan=lifespan)
# Add API routes here...
# Final catch-all route for frontend files (keep at end of file)
frontend.route(app, "/")
Frontend
Frontend serves a directory with:
- RAM caching, with zstd compression when smaller than original
- Browser caching: ETag + Last-Modified, Immutable assets
- Favicon mapping (serve PNG or other images there instead)
- SPA routing (serve browsers index.html at all paths not otherwise handled)
Dev-mode behavior with FastAPI(debug=True): requests error HTTP 409 with a message telling you to use the Vite dev server instead. Avoids accidentally using outdated frontend-build during development.
directory: Path on local filesystemindex: Index file name (default:index.html)spa: Serve index at any path (default:False)catch_all: Register a single catch-all handler instead of a route to each file; default for SPAcached: Path prefixes treated as immutable (default:/assets/)favicon: Optional path or glob (e.g./assets/logo*.png)zstdlevel: Compression level (default: 18)
ℹ️ Even when your page has a meta tag giving favicon location, browsers still try loading /favicon.ico whenever looking at something else. We find it more convenient to simply serve the image where the browser expects it, with correct MIME type. This also allows having a default favicon for your application that can be easily overriden at the reverse proxy (Caddy, Nginx) to serve the company branding if needed in deployment.
Server runner
When you need more flexibility than fastapi CLI can provide (e.g. CLI arguments to your own program), you may use this convenience to run FastAPI app with Uvicorn startup on given listen endpoints. Runs in the same process if possible but delegates to uvicorn.run() for auto-reloads and multiple workers. This would typically be called from your CLI main, which can set its own env variables to pass information to the FastAPI instances that run (Python imports only work in same-process mode).
from fastapi_vue import server
server.run("my_app.app:app", listen=["localhost:8000"])
- As a deployment option, environment
FORWARDED_ALLOW_IPScontrolsX-Forwardedtrusted IPs (default:127.0.0.1,::1).
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file fastapi_vue-1.5.0.tar.gz.
File metadata
- Download URL: fastapi_vue-1.5.0.tar.gz
- Upload date:
- Size: 17.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.9.21 {"installer":{"name":"uv","version":"0.9.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8e9916193e3013c8c31978286c1171cb63750f03542f98b288add674a024060d
|
|
| MD5 |
59a84626ef605326042f5b5947d217c7
|
|
| BLAKE2b-256 |
c1f68142f186d173ceda1516c95f8f25295cd43c0367345320e44461134deea9
|
File details
Details for the file fastapi_vue-1.5.0-py3-none-any.whl.
File metadata
- Download URL: fastapi_vue-1.5.0-py3-none-any.whl
- Upload date:
- Size: 21.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.9.21 {"installer":{"name":"uv","version":"0.9.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2a97d5e24a2be10208dbec17d03cd6271ec4ef034099f5e34d8dc9ad6387fffd
|
|
| MD5 |
7c3fc74d831c32ab2fac5bf7e9e72432
|
|
| BLAKE2b-256 |
4b2fd29f5aa861736572c1c03bb2a3f68535d2b8999f0553327a5ca5d6e41b5c
|
