{"id":22582,"library":"vite-plugin-alias","title":"Vite Plugin Alias","description":"vite-plugin-alias is a Vite plugin that automatically generates aliases for your project. Version 0.1.1 is the latest stable release, with updates that add support for Vite 4 and fix build issues. It automatically maps directory structures to import aliases, reducing manual configuration. Compared to alternatives like vite-aliases, it has a similar API but is maintained by elonehoo and includes TypeScript types. The release cadence is irregular but includes bug fixes and compatibility updates.","status":"active","version":"0.1.1","language":"javascript","source_language":"en","source_url":"https://github.com/elonehoo/vite-plugin-alias","tags":["javascript","typescript"],"install":[{"cmd":"npm install vite-plugin-alias","lang":"bash","label":"npm"},{"cmd":"yarn add vite-plugin-alias","lang":"bash","label":"yarn"},{"cmd":"pnpm add vite-plugin-alias","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Peer dependency required for the plugin to function","package":"vite","optional":false}],"imports":[{"note":"The package exports a default function; ESM import is recommended. CJS require may work but is not officially supported.","wrong":"const Alias = require('vite-plugin-alias')","symbol":"Alias","correct":"import Alias from 'vite-plugin-alias'"},{"note":"Options type is exported as a named type import, not a runtime value.","wrong":"import { ViteAliasesOptions } from 'vite-plugin-alias'","symbol":"ViteAliasesOptions","correct":"import type { ViteAliasesOptions } from 'vite-plugin-alias'"},{"note":"This symbol does not exist; the only export is the default function and the type ViteAliasesOptions.","wrong":"import { useAlias } from 'vite-plugin-alias'","symbol":"useAlias","correct":"Not applicable; the plugin does not export a hook named useAlias."}],"quickstart":{"code":"// vite.config.ts\nimport { defineConfig } from 'vite'\nimport Alias from 'vite-plugin-alias'\n\nexport default defineConfig({\n  plugins: [\n    Alias()\n  ]\n})","lang":"typescript","description":"Shows how to install and configure vite-plugin-alias in a Vite project using TypeScript."},"warnings":[{"fix":"Remove any manual 'resolve.alias' entries if using this plugin, or customize the plugin options to avoid overlap.","message":"The plugin may conflict with existing manual alias configuration in vite.config.ts, causing unexpected behavior.","severity":"gotcha","affected_versions":">=0.0.1"},{"fix":"Upgrade to version 0.0.7 or later to add Vite 4 support.","message":"Older versions (before 0.0.7) did not support Vite 4; users may experience compatibility issues.","severity":"deprecated","affected_versions":"<0.0.7"},{"fix":"Use the 'prefix' or 'deep' options to control which directories are scanned and how aliases are named.","message":"The plugin automatically resolves aliases based on folder structure; it may incorrectly map directories that are not intended to be aliases.","severity":"gotcha","affected_versions":">=0.0.1"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Run 'npm install --save-dev vite-plugin-alias' or 'pnpm install --save-dev vite-plugin-alias'.","cause":"Package not installed or devDependencies not installed correctly.","error":"Error: Cannot find module 'vite-plugin-alias'"},{"fix":"Use 'import Alias from \"vite-plugin-alias\"' instead of 'import { Alias } from \"vite-plugin-alias\"'.","cause":"Improper import; using named import instead of default import.","error":"TypeError: Alias is not a function"},{"fix":"Use 'import type { ViteAliasesOptions } from \"vite-plugin-alias\"' or simply rely on inference.","cause":"Trying to import the type as a runtime export.","error":"Error: [vite] Internal server error: The requested module 'vite-plugin-alias' does not provide an export named 'ViteAliasesOptions'"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}