Registry / devops / vite-plugin-tauri

vite-plugin-tauri

library4.0.0jsnpmunverified

Integrates Tauri into a Vite project, enabling cross-platform desktop app development with seamless dev and build workflows. Current stable version is 4.0.0, which adds support for Tauri v2 and removes the debug, verbose, and target config options in favor of CLI arguments. The plugin is actively maintained and distributed as an ESM-only package. It ships TypeScript types and requires @tauri-apps/cli >=1 and vite >=2 as peer dependencies. Key differentiators include automatic detection of Tauri project initialization, support for separate Vite configs for Tauri, and CLI argument passthrough via -- -t or --tauri syntax. Version 3.1.0 introduced a default export alongside the named export, and version 3.0.2 removed internal modification of vite clearScreen and server.open settings.

devops web-framework

npm install vite-plugin-tauri

github ↗package ↗

INSTALL

IMPORT

SIG · VITE-PLUGIN-TAURI

vite-plugin-tauri

devopsjavascriptv4.0.0

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–223 runs

build_error

glibc

node 18–223 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

tauri (default)

✓ import tauri from 'vite-plugin-tauri'

✗ const tauri = require('vite-plugin-tauri')

ESM-only; require() will fail. Default export available since v3.1.0.

tauri (named)

✓ import { tauri } from 'vite-plugin-tauri'

✗ import { Tauri } from 'vite-plugin-tauri'

Function name is lowercase 'tauri'. The named export has been available since v1.

type definitions

✓ import type { VitePluginTauriOptions } from 'vite-plugin-tauri'

✗ import { VitePluginTauriOptions } from 'vite-plugin-tauri'

Options type is exported for TypeScript users. Use type import to avoid runtime inclusion.

Shows how to install, import, and configure the plugin in a Vite config with optional but recommended settings.

// vite.config.js import { defineConfig } from 'vite'; import tauri from 'vite-plugin-tauri'; export default defineConfig({ plugins: [tauri()], clearScreen: false, server: { open: false, }, }); // Then in terminal: // pnpm add -D vite-plugin-tauri @tauri-apps/cli // npx tauri init // pnpm dev -- -t --release

Debug

Known issues

breakingRemoved debug, verbose, and target config options in v4.0.0

fix

Pass these options as Tauri CLI arguments, e.g., pnpm dev -- -t --verbose --release

affects: >=4.0.0

deprecatedNamed export { tauri } is still supported, but default export is preferred since v3.1.0

fix

Use import tauri from 'vite-plugin-tauri' instead of import { tauri } from 'vite-plugin-tauri'

affects: >=3.1.0

gotchaCommonJS require() will fail because package is ESM-only

fix

Use ES module import syntax in your project (set type:module in package.json or use .mjs files)

affects: >=3.0.0

breakingInternal modification of clearScreen and server.open was removed in v3.0.2

fix

Manually set clearScreen: false and server.open: false in your Vite config if desired

affects: >=3.0.2

Errors

Common errors & fixes

Error: Cannot find module 'vite-plugin-tauri'

Package not installed or in node_modules

fix

Run 'npm install -D vite-plugin-tauri @tauri-apps/cli'

Error [ERR_REQUIRE_ESM]: require() of ES Module /path/to/vite-plugin-tauri not supported.

Using CommonJS require() on an ESM-only package

fix

Switch to import statement: import tauri from 'vite-plugin-tauri' or set type:module in package.json

TypeError: tauri is not a function

Using default import incorrectly or wrong import path

fix

Ensure you import correctly: import tauri from 'vite-plugin-tauri' (default) or import { tauri } from 'vite-plugin-tauri' (named)

error: unknown option `--verbose'

Passing Tauri CLI arguments directly to vite without -- separator

fix

Use -- -t or -- --tauri before Tauri arguments: npm run dev -- -- -t --verbose

Upgrade

Version history

4.0.0latest on npm

Audit

Dependencies

@tauri-apps/clirequiredRequired at runtime for Tauri CLI commands executed by the plugin

Agent activity

15 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/amrbashir/vite-plugin-tauri ↗

packagehttps://www.npmjs.com/package/vite-plugin-tauri ↗