A Flask extension that integrates with Vite
Project description
Canonical Webteam Flask-Vite integration
A Flask extension that integrates with Vite, enabling use of Vite's dev server and static builds with as little configuration as possible.
Features
- easy to configure
- simple API
- supports custom Vite configurations
- supports multiple JS entry points
- supports all Vite-compatible JS frameworks
- supports all Vite-compatible stylesheet languages
- hot reloading in development mode
modulepreloadhints for JS chunks in production mode- injects
nonceattributes intoscriptandlinktags automatically (ifflask.request.CSP_NONCEis set)
How to use the extension
Install
To install this extension as a requirement in your project, you can use PIP:
pip install canonicalwebteam.flask-vite
Update your Vite configuration
Set build.manifest to true in your Vite config.
Configure
The extension reads the following values from the Flask app.config object:
VITE_MODE: "development" | "production"- type of environment in which the Vite integration will run. Defaults to"production".VITE_PORT: int- port where Vite's dev server is running. Defaults to5173.VITE_OUTDIR: str- file system path where the Vite output is expected; the path can be absolute or relative to the Flask app's root directory. Defaults to"static/dist".VITE_MANIFEST_PATH: str: Path to the Vite manifest file, relative toVITE_OUTDIR. Defaults to.vite/manifest.json(the standard for Vite v5, v6, and v7). For vite v4 and below the path ismanifest.jsonVITE_REACT: bool- only needed for React projects; set toTrueto inject React HMR dev tools in dev mode. Defaults toFalse.
Note: the extension does NOT manage the state of the Vite dev server nor produce the static builds, you are responsible for running the appropriate Vite commands before initializing the extension.
Initialize
from canonicalwebteam.flask_vite import FlaskVite
vite = FlaskVite()
vite.init_app(app)
Import resources
The extension adds a new template global function named vite_import. To include a script or stylesheet, simply invoke this template function passing the path to the file you want to import, relative to the app's root directory.
Example
To import a script whose path is < flask app directory >/js/app/main.ts:
{ vite_import("js/app/main.ts") }
Note: when importing a file via
vite_import, make sure it's also declared as an entry point in your Vite config (underbuild.rollupOptions.input); if this isn't the case, the import will break in production mode. This is because Vite's build won't contain the file you're trying to import, sovite_importwill throw aManifestContentExceptionwhen attempting to resolve the filesystem path.
Minimal usage example
# app.py
# ...
app.config["VITE_MODE"] = "development" if app.debug else "production"
FlaskVite(app)
#...
<!-- templates/index.html -->
<head>
{ vite_import("path/to/source/styles.scss") }
</head>
<body>
{ vite_import("path/to/source/file.tsx") }
</body>
For a more fleshed-out example check the example directory.
Development
The package leverages poetry for dependency management.
To set up the virtual env and install dependencies, run:
poetry install
Testing
Unit tests can be run using:
poetry run python3 -m unittest discover tests
Release history Release notifications | RSS feed
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 canonicalwebteam_flask_vite-0.5.0.tar.gz.
File metadata
- Download URL: canonicalwebteam_flask_vite-0.5.0.tar.gz
- Upload date:
- Size: 8.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.9.25
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
970b59cfc110782e3e85ae6eb57521dd604b6e8b6c34671f2bead70fd563a5c4
|
|
| MD5 |
d8d0d44955485a6b6824be96daa46667
|
|
| BLAKE2b-256 |
40afa23f82f8378c28de742b2da9ad1411117b07427d596e87007ab84a94a593
|
File details
Details for the file canonicalwebteam_flask_vite-0.5.0-py3-none-any.whl.
File metadata
- Download URL: canonicalwebteam_flask_vite-0.5.0-py3-none-any.whl
- Upload date:
- Size: 12.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.9.25
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
98463eeee8ca868a3e029c3dcb8e66e5e6636114667762737c50973f2a92ede9
|
|
| MD5 |
d25fc9e0373f4773550b82b563fb8935
|
|
| BLAKE2b-256 |
9fb304fbc0bf29dac1b19eda57c208386a0d0b012428913de3c3c05497cd5cc2
|
