{"id":22758,"library":"vite-plugin-neutralino","title":"Vite Plugin Neutralino","description":"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.","status":"active","version":"1.0.3","language":"javascript","source_language":"en","source_url":"https://github.com/PromiseAll/vite-plugin-neutralino","tags":["javascript","vite","plugin","vite-plugin","neutralino","neutralinojs","typescript"],"install":[{"cmd":"npm install vite-plugin-neutralino","lang":"bash","label":"npm"},{"cmd":"yarn add vite-plugin-neutralino","lang":"bash","label":"yarn"},{"cmd":"pnpm add vite-plugin-neutralino","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Vite plugin API dependency","package":"vite","optional":true}],"imports":[{"note":"Default export — named import will fail.","wrong":"import { neutralino } from 'vite-plugin-neutralino'","symbol":"default (neutralino)","correct":"import neutralino from 'vite-plugin-neutralino'"},{"note":"Options type is only exported as a type; use import type or inline.","wrong":"import { NeutralinoPluginOptions } from 'vite-plugin-neutralino'","symbol":"NeutralinoPluginOptions","correct":"import type { NeutralinoPluginOptions } from 'vite-plugin-neutralino'"},{"note":"CommonJS require returns the default export directly, not as named property.","wrong":"const { neutralino } = require('vite-plugin-neutralino')","symbol":"require","correct":"const neutralino = require('vite-plugin-neutralino')"}],"quickstart":{"code":"// vite.config.ts\nimport { defineConfig } from 'vite';\nimport vue from '@vitejs/plugin-vue';\nimport neutralino from 'vite-plugin-neutralino';\n\nexport default defineConfig({\n  plugins: [\n    vue(),\n    neutralino() // or neutralino({ rootPath: '../my-neutralino-app' })\n  ]\n});","lang":"typescript","description":"Add neutralino() to Vite config; zero config works for default Neutralino project structure."},"warnings":[{"fix":"Call as neutralino() or neutralino({ rootPath: 'path' }).","message":"neutralino() must be called without options or with an object — passing wrong argument type will throw.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Start Neutralinojs first (neu run) then Vite dev, or use a concurrent runner.","message":"In dev mode, the Neutralinojs app must be running before or simultaneously with Vite — plugin reads .tmp/auth_info.json.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Ensure Neutralinojs is properly installed and run in the expected environment.","message":"The plugin only injects the script tag — it does not polyfill Neutralino global; your app still needs Neutralino runtime.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"N/A","message":"No deprecated features known.","severity":"deprecated","affected_versions":"0.0.0"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Install: npm install vite-plugin-neutralino --save-dev","cause":"Package not installed or not in node_modules.","error":"Error: Cannot find module 'vite-plugin-neutralino'"},{"fix":"Change to: import neutralino from 'vite-plugin-neutralino'","cause":"Using named import instead of default import.","error":"SyntaxError: The requested module 'vite-plugin-neutralino' does not provide an export named 'neutralino'"},{"fix":"Ensure you import the default export, not a named export.","cause":"Imported the wrong thing (e.g., options type instead of function).","error":"TypeError: neutralino is not a function"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}