Litestar Vite
Litestar Vite connects the Litestar backend to a Vite toolchain. It supports SPA, Template, Inertia, and meta-framework workflows, and it can proxy Vite dev traffic through your ASGI port or run Vite directly.
Features
- One-port dev: proxies Vite HTTP + WS/HMR through Litestar on a single ASGI port by default.
- Framework-mode support: use
mode="framework"(aliasmode="ssr") for Astro, Nuxt, and SvelteKit. Litestar proxies everything except your API routes. - Production assets: reads the Vite manifest from
public/manifest.json(configurable) and serves underasset_url. - Type-safe frontends: optional OpenAPI/routes export plus
@hey-api/openapi-tsvia the Vite plugin. - Inertia support: Inertia v2/v3 protocol support with session middleware, script-element bootstrap by default, and optional SSR.
Install
pip install litestar-vite
npm install litestar-vite-plugin
Quick Start
from litestar import Litestar
from litestar_vite import VitePlugin
app = Litestar(plugins=[VitePlugin()])
litestar assets init --template vue
litestar assets install
litestar run --reload
VitePlugin() detects development and production behavior without manual VITE_DEV_MODE parsing. The effective
litestar run --host/--port values are also passed to the frontend environment and .litestar.json bridge.
Optional Granian native static serving
Granian 0.16+ can serve eligible production bundle files before the request enters Python:
from litestar import Litestar
from litestar_granian import GranianPlugin
from litestar_vite import VitePlugin
app = Litestar(
plugins=[
VitePlugin(),
GranianPlugin(static="auto"),
]
)
This is an optimization, not a separate application configuration. The Litestar static route stays registered, so Uvicorn and other ASGI servers serve the same files. Granian automatically falls back to Litestar when assets are protected, customized, missing, or otherwise unsafe to intercept.
Native hits bypass ASGI middleware, guards, compression, custom headers, and Python access logging. Keep protected or customized assets on the Litestar fallback path. See the production guide for the server matrix and advanced configuration.
Documentation
- Get started: https://litestar-org.github.io/litestar-vite/latest/usage/index.html
- Framework guides: https://litestar-org.github.io/litestar-vite/latest/frameworks/index.html
- Inertia: https://litestar-org.github.io/litestar-vite/latest/frameworks/inertia/index.html
- API reference: https://litestar-org.github.io/litestar-vite/latest/reference/index.html
- Changelog: https://litestar-org.github.io/litestar-vite/latest/changelog.html
Common Commands
litestar assets init --template <name>: scaffold a frontend or framework applitestar assets install: install frontend dependencies with the configured executorlitestar assets build: build production assetslitestar assets serve: run the frontend toolchain directlylitestar assets generate-types: export OpenAPI, routes, and Inertia page-prop metadatalitestar assets doctor: inspect and optionally repair config drift
Development
# Install Python, docs, and JS dependencies; build package artifacts
make install && make build
# Run an example app
uv run litestar --app-dir examples/vue-inertia assets install
uv run litestar --app-dir examples/vue-inertia run
Replace vue-inertia with any other example app: vue, react, svelte, react-inertia, htmx, angular, astro, nuxt, or sveltekit.
litestar-vite now defaults Inertia apps to script-element bootstrap. Inertia v3 clients use that transport automatically; if you pin Inertia v2, keep createInertiaApp({ defaults: { future: { useScriptElementForInitialPage: true } } }) aligned in the browser entry and SSR entry when ssr=True is enabled, or opt back into the legacy data-page path with InertiaConfig(use_script_element=False).
Links
- Docs: https://litestar-org.github.io/litestar-vite/latest/
- Examples:
examples/(React, Vue, Svelte, HTMX, Inertia, Astro, Nuxt, SvelteKit, Angular) - Real-world example: litestar-fullstack
- Issues: https://github.com/litestar-org/litestar-vite/issues/
2 maintainers
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 litestar_vite-0.31.0.tar.gz.
File metadata
- Download URL: litestar_vite-0.31.0.tar.gz
- Upload date:
- Size: 597.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4030be77e98ea2ff2ab73660be2b83a0e8c3ea724ae499e1a021f88be1ea0118
|
|
| MD5 |
8638846eb47e3a91dcd2a4f33752876e
|
|
| BLAKE2b-256 |
54f1e81d0021f2620aca0aaa492ecc096e0355ec6b82f6862cb857cb0d527a8f
|
Provenance
The following attestation bundles were made for litestar_vite-0.31.0.tar.gz:
Publisher:
publish.yml on litestar-org/litestar-vite
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
litestar_vite-0.31.0.tar.gz -
Subject digest:
4030be77e98ea2ff2ab73660be2b83a0e8c3ea724ae499e1a021f88be1ea0118 - Sigstore transparency entry: 2499946931
- Sigstore integration time:
-
Permalink:
litestar-org/litestar-vite@1b6f71e123e319dcde135e0e24f4ad5f3013ec54 -
Branch / Tag:
refs/tags/v0.31.0 - Owner: https://github.com/litestar-org
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@1b6f71e123e319dcde135e0e24f4ad5f3013ec54 -
Trigger Event:
release
-
Statement type:
File details
Details for the file litestar_vite-0.31.0-py3-none-any.whl.
File metadata
- Download URL: litestar_vite-0.31.0-py3-none-any.whl
- Upload date:
- Size: 289.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e7d19c384af9253cc11e913d411294214ed549f7761f3f73f0218971e694be7b
|
|
| MD5 |
79321960c02deaed310069c48bec15c9
|
|
| BLAKE2b-256 |
6810274b09b684ce84480ac2ac7b84c14527433d5ee9f1bcadc814439a845c2c
|
Provenance
The following attestation bundles were made for litestar_vite-0.31.0-py3-none-any.whl:
Publisher:
publish.yml on litestar-org/litestar-vite
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
litestar_vite-0.31.0-py3-none-any.whl -
Subject digest:
e7d19c384af9253cc11e913d411294214ed549f7761f3f73f0218971e694be7b - Sigstore transparency entry: 2499946936
- Sigstore integration time:
-
Permalink:
litestar-org/litestar-vite@1b6f71e123e319dcde135e0e24f4ad5f3013ec54 -
Branch / Tag:
refs/tags/v0.31.0 - Owner: https://github.com/litestar-org
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@1b6f71e123e319dcde135e0e24f4ad5f3013ec54 -
Trigger Event:
release
-
Statement type:
