fastapi-vue-setup
Create or patch a FastAPI + Vue project with an integrated dev/build workflow.
- Development: one command runs Vite + FastAPI (reloads)
- Production:
uv buildbakes the built Vue assets into the Python package (no Node/JS runtime needed to run the installed package)
Quick start
Install UV and any JS runtime (node, deno, or bun).
This README uses my-app as the example project name:
- project directory:
my-app/ - Python module:
my_app - env prefix:
MY_APP - CLI command:
my-app
Create a new project in ./my-app:
uvx fastapi-vue-setup my-app
Once in your source tree, you will typically use . for the path. If there is an existing project, fastapi-vue-setup will do its best to find and patch a backend module and create or patch a Vue project in frontend/. The integration can be upgraded by running a new version of fastapi-vue-setup on it, preserving earlier default ports and user customizations.
In your project
ℹ️ Everything below is meant to be run within your project source tree.
The setup creates a CLI entry for your package, so that it becomes a command to run, not a Python module nor fastapi myapp.... The CLI main can be customized, although --listen should be kept for devserver compatibility.
You can choose the JS runtime with environment JS_RUNTIME (e.g. node, deno, bun, or path to one). This is used by the build and the devserver scripts. By default any available runtime on the system is chosen.
Development server (Vite + FastAPI)
uv run scripts/devserver.py [args]
ℹ️ Arguments are forwarded to the main CLI, except that --listen controls where Vite listens, and --backend is passed to main CLI as --listen.
Production
Build the Python package (this compiles the Vue frontend) and run the production server:
uv build && uv run my-app [args]
Once happy with it, publish the package
uv build && uv publish
Afterwards, you can easily run it anywhere, no JS runtimes required:
uvx my-app [args]
ℹ️ Instead of uvx you may consider uv tool install, oldskool pip install or whatever best suits you.
Vite plugin
The generated Vite plugin lives in frontend/vite-plugin-fastapi.js and defaults to proxying /api.
It reads MY_APP_BACKEND_URL to know where to proxy; if unset it falls back to your configured default backend port.
Project layout (typical)
my-app/
├── frontend/ # Vue app (Vite)
│ ├── src/
│ ├── vite-plugin-fastapi.js
│ └── package.json
├── my_app/ # Python package
│ ├── __main__.py # CLI entrypoint
│ ├── app.py # FastAPI app
│ └── frontend-build/ # built assets (included in distributions)
├── pyproject.toml
└── scripts/
├── devserver.py # Run Vite and FastAPI together in dev mode
└── fastapi-vue/ # Dev utilities (only on the source tree)
├── buildhook.py
├── buildutil.py
└── devutil.py
The fastapi-vue runtime module
The backend runs the FastAPI app and serves the frontend build using the companion package in fastapi-vue/README.md. Your project will depend on Fastapi and this lightweight module.
ℹ️ Development functionality is in scripts/fastapi-vue/ directly in your source tree, and is not to be confused with this runtime module. Only the runtime is installed with your package.
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_setup-1.5.0.tar.gz.
File metadata
- Download URL: fastapi_vue_setup-1.5.0.tar.gz
- Upload date:
- Size: 42.4 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 |
012c66ca3da9e9df3150df19a24c2e50efbac8d33f4106e1c6cc02fde4e772ae
|
|
| MD5 |
e68e530631af8ce04c3203c34cea569c
|
|
| BLAKE2b-256 |
f442952264873d15247b0f17349e365095a0cd7810755be1a3a625c52404755b
|
File details
Details for the file fastapi_vue_setup-1.5.0-py3-none-any.whl.
File metadata
- Download URL: fastapi_vue_setup-1.5.0-py3-none-any.whl
- Upload date:
- Size: 28.7 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 |
632641bdf10bf58f5d44c158859a1032e6e62ac65d50e5471ca1577f6451cd8a
|
|
| MD5 |
d58364a58c5ba29559441721c4e21170
|
|
| BLAKE2b-256 |
aa90794d44d1e3a80e1e87b929465c3f8c18c7860e83355c01846d2fc667d3b8
|
