Pre-release

This release is a pre-release and may not be stable for production use.

Litestar Vite

Litestar Vite connects the Litestar backend to a Vite toolchain. It supports SPA, Template, and Inertia flows, and can proxy Vite dev traffic through your ASGI port or run Vite directly.

Features

  • One-port dev: proxies Vite HTTP + WS/HMR through Litestar by default; switch to two-port with VITE_PROXY_MODE=direct.
  • Production assets: reads Vite manifest from public/manifest.json (configurable) and serves under asset_url.
  • Type-safe frontends: optional OpenAPI/routes export + @hey-api/openapi-ts via the Vite plugin.
  • Inertia support: v2 protocol with session middleware and optional SPA mode.

Quick start (React TanStack SPA)

pip install litestar-vite
litestar assets init --template react-tanstack
litestar assets install  # installs frontend deps via configured executor

from litestar import Litestar
from litestar_vite import VitePlugin, ViteConfig

app = Litestar(plugins=[VitePlugin(config=ViteConfig(dev_mode=True))])  # SPA mode by default

litestar run --reload  # starts Litestar; Vite dev is proxied automatically

Other templates: react, vue, svelte, htmx, react-inertia, vue-inertia, svelte-inertia, angular, angular-cli, astro, nuxt, sveltekit (see litestar assets init --help).

Template / HTMX

from litestar import Litestar
from litestar.contrib.jinja import JinjaTemplateEngine
from litestar.template.config import TemplateConfig
from litestar_vite import VitePlugin, ViteConfig

app = Litestar(
    template_config=TemplateConfig(engine=JinjaTemplateEngine(directory="templates")),
    plugins=[VitePlugin(config=ViteConfig(mode="template", dev_mode=True))],
)

Inertia (v2)

Requires session middleware.

from litestar import Litestar
from litestar.middleware.session.client_side import CookieBackendConfig
from litestar_vite import VitePlugin, ViteConfig
from litestar_vite.inertia import InertiaPlugin
from litestar_vite.inertia.config import InertiaConfig

session_backend = CookieBackendConfig(secret="dev-secret")

app = Litestar(
    middleware=[session_backend.middleware],
    plugins=[
        VitePlugin(config=ViteConfig(mode="template", inertia=True, dev_mode=True)),
        InertiaPlugin(InertiaConfig()),
    ],
)

Type generation

VitePlugin(config=ViteConfig(types=True))  # enable exports

litestar assets generate-types  # one-off or CI

CLI cheat sheet

  • litestar assets doctor — diagnose/fix config
  • litestar assets init --template react|vue|svelte|... — scaffold frontend
  • litestar assets build / serve — build or watch
  • litestar assets deploy --storage gcs://bucket/assets — upload via fsspec
  • litestar assets generate-types — OpenAPI + routes → TS types
  • litestar assets install — install frontend deps with the configured executor

Doctor command highlights

  • Prints Python vs Vite config snapshot (asset URLs, bundle/hot paths, ports, modes).
  • Flags missing hot file (dev proxy), missing manifest (prod), type-gen exports, env/config mismatches, and plugin install issues.
  • --fix can rewrite simple vite.config values (assetUrl, bundleDirectory, hotFile, type paths) after creating a backup.

Links

Project links

Data verified by PyPI on Nov 30, 2025
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.31.0)

Owner

PyPI data
Data sourced directly from PyPI's database.

2 maintainers

PyPI data
Data sourced directly from PyPI's database.
Avatar for cofin from gravatar.com cofin Avatar for provinzkraut from gravatar.com provinzkraut

Credits

Author: Cody Fincher

GitHub Statistics

Data verified by PyPI on Nov 30, 2025
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

MIT License (MIT)

Requires

Python >=3.10

Provides Extra

http2 jinja nodeenv

Tags

litestar vite

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

litestar_vite-0.15.0a2.tar.gz (167.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

litestar_vite-0.15.0a2-py3-none-any.whl (141.7 kB view details)

Uploaded Python 3

File details

Details for the file litestar_vite-0.15.0a2.tar.gz.

File metadata

  • Download URL: litestar_vite-0.15.0a2.tar.gz
  • Upload date:
  • Size: 167.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for litestar_vite-0.15.0a2.tar.gz
Algorithm Hash digest
SHA256 f241ee8a985ffc5ee65eb0849e3ec497102d904f1a052b113c3fdd80f0bc4a62
MD5 974dba0c5fe59b82df545cbc8ba16031
BLAKE2b-256 b6cc220f174d85f43b3180b01bc2585865c49c06faa2adf4523103f0c8412f4f

See more details on using hashes here.

Provenance

The following attestation bundles were made for litestar_vite-0.15.0a2.tar.gz:

Publisher: publish.yml on litestar-org/litestar-vite

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file litestar_vite-0.15.0a2-py3-none-any.whl.

File metadata

File hashes

Hashes for litestar_vite-0.15.0a2-py3-none-any.whl
Algorithm Hash digest
SHA256 a89accbf34a99045cc20605d1493edcf111feae300286561118a5f68dff1f093
MD5 4cdbe892cb826220770ef737cfbf8df3
BLAKE2b-256 0f9df9eee2f4618fef3199917994c120aca695cffde70f7248274a1823e5e4c1

See more details on using hashes here.

Provenance

The following attestation bundles were made for litestar_vite-0.15.0a2-py3-none-any.whl:

Publisher: publish.yml on litestar-org/litestar-vite

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.31.0

2 files

0.30.1

2 files

0.30.0

2 files

0.29.1

2 files

0.29.0

2 files

0.28.0

2 files

0.27.0

2 files

0.26.1

2 files

0.26.0

2 files

0.25.0

2 files

0.24.1

2 files

0.24.0

2 files

0.23.4

2 files

0.23.3

2 files

0.23.2

2 files

0.23.1

2 files

0.23.0

2 files

0.22.2

2 files

0.22.1

2 files

0.22.0

2 files

0.21.1

2 files

0.21.0

2 files

0.20.0

2 files

0.19.0

2 files

0.18.4

2 files

0.18.3

2 files

0.18.2

2 files

0.18.1

2 files

0.18.0

2 files

0.17.0

2 files

0.16.4

2 files

0.16.3

2 files

0.16.2

2 files

0.15.0

2 files

Pre-release

0.15.0rc5

2 files

Pre-release

0.15.0rc4

2 files

Pre-release

0.15.0rc3

2 files

Pre-release

0.15.0rc2

2 files

Pre-release

0.15.0rc1

2 files

Pre-release

0.15.0b6

2 files

Pre-release

0.15.0b5

2 files

Pre-release

0.15.0b4

2 files

Pre-release

0.15.0b3

2 files

Pre-release

0.15.0b2

2 files

Pre-release

0.15.0b1

2 files

Pre-release

0.15.0a7

2 files

Pre-release

0.15.0a6

2 files

Pre-release

0.15.0a5

2 files

Pre-release

0.15.0a4

2 files

Pre-release

0.15.0a3

2 files

This release
Pre-release

0.15.0a2 This release

2 files

Pre-release

0.15.0a1

2 files

0.14.0

2 files

0.13.2

2 files

0.13.1

2 files

0.13.0

2 files

0.12.1

2 files

0.12.0

2 files

0.11.1

2 files

0.11.0

2 files

0.10.0

2 files

0.9.0

2 files

0.8.3

2 files

0.8.2

2 files

0.8.1

2 files

0.8.0

2 files

0.7.1

2 files

0.7.0

2 files

0.2.9

2 files

0.2.8

2 files

0.2.7

2 files

0.2.6

2 files

0.2.5

2 files

0.2.4

2 files

0.2.3

2 files

0.2.2

2 files

0.2.1

2 files

0.2.0

2 files

0.1.22

2 files

0.1.21

2 files

0.1.20

2 files

0.1.19

2 files

0.1.18

2 files

0.1.17

2 files

0.1.16

2 files

0.1.15

2 files

0.1.14

2 files

0.1.13

2 files

0.1.12

2 files

0.1.11

2 files

0.1.10

2 files

0.1.9

2 files

0.1.8

2 files

0.1.7

2 files

0.1.6

2 files

0.1.5

2 files

0.1.4

2 files

0.1.3

2 files

0.1.2

2 files

0.1.1

2 files

0.1.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page