{"id":22552,"library":"vite-electron-app","title":"vite-electron-app","description":"vite-electron-app is a CLI tool (v1.4.0) for scaffolding Electron + Vite + React + TypeScript desktop applications. It generates a minimalistic, secure-by-default project structure with hot reload, Electron Builder packaging, Vitest testing, and organized separation of concerns. The tool uses npx for instant scaffolding without global install and is idempotent, allowing multiple runs without duplication. Active development with regular releases on npm. Differentiators include native TypeScript, React with Vite, and built-in security against dangerous files.","status":"active","version":"1.4.0","language":"javascript","source_language":"en","source_url":"https://github.com/joaomjbraga/vite-electron-app","tags":["javascript","electron","vite","react","typescript","starter","boilerplate","desktop","scaffold"],"install":[{"cmd":"npm install vite-electron-app","lang":"bash","label":"npm"},{"cmd":"yarn add vite-electron-app","lang":"bash","label":"yarn"},{"cmd":"pnpm add vite-electron-app","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"CLI command parsing","package":"commander","optional":false},{"reason":"Interactive prompts for project configuration","package":"inquirer","optional":false}],"imports":[{"note":"Recommended usage is via npx to avoid global install pollution. Global install is still supported but not recommended.","wrong":"npm install -g vite-electron-app && vite-electron-app <project-name>","symbol":"vite-electron-app","correct":"npx vite-electron-app <project-name>"}],"quickstart":{"code":"npx vite-electron-app my-app\ncd my-app\npnpm install\npnpm dev","lang":"typescript","description":"Scaffold, install dependencies, and start development server for a new Electron + Vite + React app."},"warnings":[{"fix":"Use Node.js 18+ and install pnpm via 'npm install -g pnpm'.","message":"Requires Node.js >= 18 and pnpm (not npm) for best results.","severity":"gotcha","affected_versions":">=1.0"},{"fix":"Use npx instead of global install.","message":"The global install pattern is deprecated; usage via npx is now the primary method.","severity":"deprecated","affected_versions":">=1.0"},{"fix":"If upgrading from older versions, migrate packaging setup to Electron Builder.","message":"In version 1.4.0, the project structure changed: templates now use Electron Builder for packaging instead of electron-forge.","severity":"breaking","affected_versions":">=1.4.0"},{"fix":"Ensure you have backups or use a fresh directory name.","message":"If the target directory already exists, the tool will prompt to overwrite. But if you answer 'yes', the directory contents are replaced.","severity":"gotcha","affected_versions":">=1.0"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Run 'npx vite-electron-app' from a clean project directory after installing dependencies with pnpm.","cause":"Running the CLI from a wrong directory or missing dependencies.","error":"Error: Cannot find module '../src/index' from 'vite-electron-app'"},{"fix":"Install Node.js (version 18+) via https://nodejs.org or nvm.","cause":"npx is not available in the shell (usually due to missing npm or Node.js).","error":"zsh: command not found: npx"},{"fix":"Install pnpm globally by running 'npm install -g pnpm'.","cause":"pnpm is not installed.","error":"Failed to install dependencies: The pnpm command was not found"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}