First-class Vite 7+, Inertia.js, Island Fragments, and End-to-End Type Generation for Litestar
Documentation · Getting Started · Inertia.js · API Reference · Discord
Litestar Vite connects Litestar (Python ASGI) to the Vite 7+ frontend toolchain through a single-port AnyIO streaming proxy, deterministic .litestar.json runtime bridge, Inertia.js protocol support, server-rendered UI islands, and automatic OpenAPI + AsyncAPI TypeScript generation.
Install
uv add litestar-vite
npm install -D litestar-vite-plugin
Or with pip:
pip install litestar-vite
Quickstart
from litestar import Litestar
from litestar_vite import VitePlugin
app = Litestar(plugins=[VitePlugin()])
Scaffold a frontend template, install dependencies, and run both Litestar and Vite on a single port:
litestar assets init --template react-inertia
litestar assets install
litestar run --reload
Capabilities
| Capability | What it provides |
|---|---|
| Single-Port AnyIO Dev Proxy | Streams Vite HTTP assets and upgrades /vite-hmr WebSockets directly through your Litestar port (:8000) with zero CORS setup |
| Four Operating Modes | First-class support for spa, hybrid (Inertia.js), template (Jinja2 + <litestar-island>), and framework (Astro, Nuxt, SvelteKit) |
| Inertia.js Protocol & SSR | Native defer(), merge(), once(), shared session props, Laravel Precognition validation, and fault-tolerant SSR (RunnableDevEnvironment in dev, StdioIPCTransport worker in prod) |
| End-to-End Type Generation | Deterministic SHA-256 openapi.json, routes.json, and asyncapi.json artifacts driving @hey-api/openapi-ts, ziggy-style route() / wsRoute(), and createTypedChannels() |
| Islands & HTMX Fragments | Server-rendered UI components via ComponentResponse, Jinja vite_fragment(), and <litestar-island> hydration with automatic CSS chunk injection |
| Production & Cloud Deployment | Manifest-resolved hashed bundles, immutable caching, subresource integrity (integrity), and fsspec CDN deployment (litestar assets deploy) |
Documentation
- Getting Started & Quick Starts
- Core Concepts & Operating Modes
- Inertia.js Guide
- TypeGen, Typed Routes & Realtime Channels
- Internal Architecture & Animated Diagrams
- Python, TypeScript & CLI Reference
Contributing & License
Contributions are welcome — see the Contributing & Development Guide for local workspace setup, test commands, and architecture guidelines. Distributed under the MIT License.
2 maintainers
Metadata
2 maintainers
Release files for litestar-vite 0.33.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| litestar_vite-0.33.0.tar.gz | 752.2 kB | With provenance | Details for litestar_vite-0.33.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| litestar_vite-0.33.0-py3-none-any.whl | Python 3 | none | any | Details for litestar_vite-0.33.0-py3-none-any.whl |
Total release size: 1.1 MB
Release files / litestar_vite-0.33.0.tar.gz
| Download URL | litestar_vite-0.33.0.tar.gz |
|---|---|
| Size | 752.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2ca2b2aed5dcbc54675d85384b37af9e34ee3ad7f6074e574a6f3c22675b413e
|
|
BLAKE2b-256 checksum How to use checksums |
c965896065bba79ff0731bdbbd7967e6baf844b6f44203a80a5c0f80ecd4a6d0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 3, 2026.
Transparency logRelease files / litestar_vite-0.33.0-py3-none-any.whl
| Download URL | litestar_vite-0.33.0-py3-none-any.whl |
|---|---|
| Size | 327.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
aed57a740e1876d4176e97e7cc9ea4b14a6d9b63b626dd3ba6dd1a6e109e1301
|
|
BLAKE2b-256 checksum How to use checksums |
e2b127ac1c2b2d4592f7f4a91ce2dcbe53ef907179227dc34aeea3c3697600ee
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 3, 2026.
Transparency logSecurity for litestar-vite 0.33.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for litestar_vite-0.33.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 3, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
