Registry / devops / zmp-vite-plugin

zmp-vite-plugin

library1.1.6jsnpmunverified

A Vite plugin for Zalo Mini App development that integrates with the standard Vite build pipeline. Current stable version is 1.1.6, released under an active maintenance cadence. The plugin automatically reads app-config.json, supports React and vendor chunk splitting, and works with Vite 4 or 5. It simplifies deployment via zmp-cli and is the official Vite integration for Zalo Mini Apps, distinct from other mini-app frameworks.

devops web-framework

npm install zmp-vite-plugin

package ↗

INSTALL

IMPORT

SIG · ZMP-VITE-PLUGIN

zmp-vite-plugin

devopsjavascriptv1.1.6

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.

default

✓ import zaloMiniApp from 'zmp-vite-plugin'

✗ import { zaloMiniApp } from 'zmp-vite-plugin'

The default export is the plugin function.

zaloMiniApp

✓ const zaloMiniApp = require('zmp-vite-plugin').default

✗ const zaloMiniApp = require('zmp-vite-plugin')

CommonJS require must use .default to get the plugin function.

PluginOptions

✓ import type { PluginOptions } from 'zmp-vite-plugin'

✗ import { PluginOptions } from 'zmp-vite-plugin'

Type import for TypeScript users; avoid value import as it's a type.

Shows how to set up the plugin in a Vite config with React and vendor chunk splitting.

// vite.config.ts import { defineConfig, splitVendorChunkPlugin } from 'vite'; import react from '@vitejs/plugin-react'; import zaloMiniApp from 'zmp-vite-plugin'; export default () => { return defineConfig({ plugins: [ react(), splitVendorChunkPlugin(), zaloMiniApp(), ], }); };

Debug

Known issues

gotchaThe plugin reads app-config.json by default; providing options object overrides this.

fix

Either rely on app-config.json or pass explicit options to the plugin.

affects: >=1.0.0

gotchaRequires Vite ^4.2.0 || ^5.0.0. Using other Vite versions may cause incompatibility.

fix

Ensure Vite version matches peer dependency.

affects: >=1.0.0

gotchaPlugin is ESM-only; not compatible with CJS Vite configs unless using dynamic import.

fix

Use ESM syntax (import/export) in vite.config.ts or use dynamic require with .default.

affects: >=1.0.0

Errors

Common errors & fixes

Cannot find module 'zmp-vite-plugin'

Plugin not installed or in devDependencies

fix

Run: npm i -D zmp-vite-plugin

TypeError: zaloMiniApp is not a function

Importing named export instead of default

fix

Change to: import zaloMiniApp from 'zmp-vite-plugin'

Unhandled rejection: TypeError: Cannot read properties of undefined (reading 'name')

app-config.json missing or malformed

fix

Create a valid app-config.json in project root.

Upgrade

Version history

1.1.6latest on npm

Audit

Dependencies

viterequiredPeer dependency required for plugin to function

Agent activity

40 hits · last 30 days

node

OpenAI (training)

Resources

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