Registry / devops / vite-plugin-domain

vite-plugin-domain

JSON →
library2.0.5jsnpmunverified

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.

devopsweb-framework
npm install vite-plugin-domain
github ↗package ↗
INSTALL
IMPORT
SIG · VITE-PLUGIN-DOMAIN
V
vite-plugin-domain
devopsjavascriptv2.0.5
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 domain from 'vite-plugin-domain'
✗ import { domain } from 'vite-plugin-domain'
Default export only. Named import will fail.
default
✓ const domain = require('vite-plugin-domain')
✗ const { domain } = require('vite-plugin-domain')
CJS require works, but wrong destructuring.
VitePluginDomainOptions
✓ import type { VitePluginDomainOptions } from 'vite-plugin-domain'
Type is exported for configuration.

Basic setup: imports vite-plugin-domain and adds plugin to Vite config.

// vite.config.ts import { defineConfig } from 'vite' import domain from 'vite-plugin-domain' export default defineConfig({ plugins: [ domain() ] })
Debug
Known issues
breakingVersion 2.0 removed default domain generation; now uses folder or package name.
fix
Update configuration with nameSource or explicit domain.
affects: >=2.0.0 <2.0.0
gotchaCaddy must be running separately with admin API enabled.
fix
Run 'caddy run' before starting Vite.
affects: >=1.0.0
gotchaUsing .local TLD may require /etc/hosts entry to avoid mDNS conflicts.
fix
Add '127.0.0.1 yourdomain.local' to /etc/hosts.
affects: >=1.0.0
gotchaNode.js 18+ required; older versions fail to import.
fix
Upgrade Node to >=18.
affects: >=2.0.0
Errors
Common errors & fixes
ERR_PACKAGE_PATH_NOT_EXPORTED: Package import specifier "vite-plugin-domain" is not defined
Missing default export or using named import incorrectly.
fix
Use default import: import domain from 'vite-plugin-domain'
Error: Cannot find module 'vite-plugin-domain'
Package not installed.
fix
pnpm add -D vite-plugin-domain
Error: connect ECONNREFUSED 127.0.0.1:2019
Caddy admin API not running.
fix
Run 'caddy run' in terminal.
Upgrade
Version history
2.0.5latest on npm
Audit
Dependencies
viteoptionalpeer dependency
Agent activity
8 hits · last 30 days
node
7
OpenAI (training)
1
Resources
githubhttps://github.com/mustafa0x/vite-plugin-domain ↗
packagehttps://www.npmjs.com/package/vite-plugin-domain ↗
vite-plugin-domain — npm install vite-plugin-domain · libregistry