{"id":22640,"library":"vite-plugin-domain","title":"vite-plugin-domain","description":"Vite plugin that automatically configures a local domain via Caddy for your dev server. Current version 2.0.5. Active maintenance with TypeScript types. Generates domain names from folder or package.json, sets up Caddy reverse proxy with HTTPS, and shares one Caddy instance across projects. Key differentiator: eliminates localhost port confusion for multi-app development.","status":"active","version":"2.0.5","language":"javascript","source_language":"en","source_url":"https://github.com/mustafa0x/vite-plugin-domain","tags":["javascript","vite","vite-plugin","domain","caddy","local","https","typescript"],"install":[{"cmd":"npm install vite-plugin-domain","lang":"bash","label":"npm"},{"cmd":"yarn add vite-plugin-domain","lang":"bash","label":"yarn"},{"cmd":"pnpm add vite-plugin-domain","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"peer dependency","package":"vite","optional":true}],"imports":[{"note":"Default export only. Named import will fail.","wrong":"import { domain } from 'vite-plugin-domain'","symbol":"default","correct":"import domain from 'vite-plugin-domain'"},{"note":"CJS require works, but wrong destructuring.","wrong":"const { domain } = require('vite-plugin-domain')","symbol":"default","correct":"const domain = require('vite-plugin-domain')"},{"note":"Type is exported for configuration.","symbol":"VitePluginDomainOptions","correct":"import type { VitePluginDomainOptions } from 'vite-plugin-domain'"}],"quickstart":{"code":"// vite.config.ts\nimport { defineConfig } from 'vite'\nimport domain from 'vite-plugin-domain'\n\nexport default defineConfig({\n  plugins: [\n    domain()\n  ]\n})","lang":"typescript","description":"Basic setup: imports vite-plugin-domain and adds plugin to Vite config."},"warnings":[{"fix":"Update configuration with nameSource or explicit domain.","message":"Version 2.0 removed default domain generation; now uses folder or package name.","severity":"breaking","affected_versions":">=2.0.0 <2.0.0"},{"fix":"Run 'caddy run' before starting Vite.","message":"Caddy must be running separately with admin API enabled.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Add '127.0.0.1 yourdomain.local' to /etc/hosts.","message":"Using .local TLD may require /etc/hosts entry to avoid mDNS conflicts.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Upgrade Node to >=18.","message":"Node.js 18+ required; older versions fail to import.","severity":"gotcha","affected_versions":">=2.0.0"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Use default import: import domain from 'vite-plugin-domain'","cause":"Missing default export or using named import incorrectly.","error":"ERR_PACKAGE_PATH_NOT_EXPORTED: Package import specifier \"vite-plugin-domain\" is not defined"},{"fix":"pnpm add -D vite-plugin-domain","cause":"Package not installed.","error":"Error: Cannot find module 'vite-plugin-domain'"},{"fix":"Run 'caddy run' in terminal.","cause":"Caddy admin API not running.","error":"Error: connect ECONNREFUSED 127.0.0.1:2019"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}