Registry / web-framework / vite-plugin-neutralino

vite-plugin-neutralino

library1.0.3jsnpmunverified

A Vite plugin (v1.0.3, stable) that seamlessly integrates Neutralinojs with Vite by automatically injecting the __neutralino_globals.js script into index.html. In development it discovers the Neutralinojs backend port from .tmp/auth_info.json and connects; in production it sets the correct script path. Zero-config, TypeScript types included, supports custom root paths. Differentiator: automatic port/connection handling compared to manual Neutralino integration.

web-framework

npm install vite-plugin-neutralino

github ↗package ↗

INSTALL

IMPORT

SIG · VITE-PLUGIN-NEUTRA

vite-plugin-neutralino

web-frameworkjavascriptv1.0.3

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 (neutralino)

✓ import neutralino from 'vite-plugin-neutralino'

✗ import { neutralino } from 'vite-plugin-neutralino'

Default export — named import will fail.

NeutralinoPluginOptions

✓ import type { NeutralinoPluginOptions } from 'vite-plugin-neutralino'

✗ import { NeutralinoPluginOptions } from 'vite-plugin-neutralino'

Options type is only exported as a type; use import type or inline.

require

✓ const neutralino = require('vite-plugin-neutralino')

✗ const { neutralino } = require('vite-plugin-neutralino')

CommonJS require returns the default export directly, not as named property.

Add neutralino() to Vite config; zero config works for default Neutralino project structure.

// vite.config.ts import { defineConfig } from 'vite'; import vue from '@vitejs/plugin-vue'; import neutralino from 'vite-plugin-neutralino'; export default defineConfig({ plugins: [ vue(), neutralino() // or neutralino({ rootPath: '../my-neutralino-app' }) ] });

Debug

Known issues

gotchaneutralino() must be called without options or with an object — passing wrong argument type will throw.

fix

Call as neutralino() or neutralino({ rootPath: 'path' }).

affects: >=1.0.0

gotchaIn dev mode, the Neutralinojs app must be running before or simultaneously with Vite — plugin reads .tmp/auth_info.json.

fix

Start Neutralinojs first (neu run) then Vite dev, or use a concurrent runner.

affects: >=1.0.0

gotchaThe plugin only injects the script tag — it does not polyfill Neutralino global; your app still needs Neutralino runtime.

fix

Ensure Neutralinojs is properly installed and run in the expected environment.

affects: >=1.0.0

deprecatedNo deprecated features known.

fix

N/A

affects: 0.0.0

Errors

Common errors & fixes

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

Package not installed or not in node_modules.

fix

Install: npm install vite-plugin-neutralino --save-dev

SyntaxError: The requested module 'vite-plugin-neutralino' does not provide an export named 'neutralino'

Using named import instead of default import.

fix

Change to: import neutralino from 'vite-plugin-neutralino'

TypeError: neutralino is not a function

Imported the wrong thing (e.g., options type instead of function).

fix

Ensure you import the default export, not a named export.

Upgrade

Version history

1.0.3latest on npm

Audit

Dependencies

viteoptionalVite plugin API dependency

Agent activity

9 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/PromiseAll/vite-plugin-neutralino ↗

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