Skip to main content
skill CX Codex

vite · itechmeat — Claude Code skill: what it does, how to install

This skill guides an agent through Vite setup, builds, plugins, HMR, and environment settings when a project needs frontend tooling support.

MIT 111 installs ★ 23 updated 2026-10-24

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add itechmeat/llm-code --skill vite -a claude-code
Open on GitHub

What vite does

The skill covers Vite project setup, the development server, production builds, and vite.config.*. It guides plugin configuration, HMR and JavaScript API usage, loading config values with loadEnv, and handling modes and environment variables.

Its recipes cover npm create vite@latest, aliases, multi-page applications, and dependency discovery through optimizeDeps.include/exclude. The reference also addresses the Environment API and the move from rollupOptions to rolldownOptions. When an app does not use index.html, set the top-level input; otherwise the same entry path may need to be repeated across several options.

The skill works with Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode. Claude Code installation uses npx and the itechmeat/llm-code repository.

What it helps with

  • configure vite.config.* for a project
  • run a Vite dev server and build
  • add a plugin with the right hooks
  • debug HMR and JavaScript API usage
  • set modes and environment variables

Example prompts for the agent

  • Set up this Vite project and create its vite.config.* configuration.
  • Add a Vite plugin with hotUpdate and apply hooks, then explain the settings.
  • Build this app without index.html using the top-level input, and check optimizeDeps.entries.

How to install vite

1Skills CLI (Vercel)

npx skills add itechmeat/llm-code --skill vite -a claude-code

2Manually: put the files in place

~/.claude/skills/vite/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/vite/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about vite

How do I install vite in Claude Code?

Run npx skills add itechmeat/llm-code --skill vite -a claude-code, then check ~/.claude/skills/vite/SKILL.md.

What does the vite skill do?

It helps an agent handle Vite setup, dev servers, builds, configuration, plugins, HMR, the Environment API, and environment variables.

Which platforms support vite?

The skill supports Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode.

Source text

SKILL.md · MIT
---
name: vite
description: "Vite next-gen frontend tooling: dev server, HMR, build, config, plugins, Environment API, Rolldown. Use when setting up or running a Vite project, configuring vite.config.*, authoring plugins, working with HMR or JS API, or managing environment variables and modes. Keywords: vite.config, bundler, Vite, HMR, Rolldown."
metadata:
  version: "8.3.5"
  release_date: "2026-10-21"
---

# Vite

## Quick navigation

- Getting started: references/getting-started.md
- Philosophy and rationale: references/philosophy.md, references/why-vite.md
- Features: references/features.md
- CLI: references/cli.md
- Plugins (usage): references/using-plugins.md
- Plugin API: references/api-plugin.md
- HMR API: references/api-hmr.md
- JavaScript API: references/api-javascript.md
- Config reference: references/config.md
- Dependency optimization: references/dep-pre-bundling.md
- Assets: references/assets.md
- Build: references/build.md
- Static deploy: references/static-deploy.md
- Env & modes: references/env-and-mode.md
- SSR: references/ssr.md
- Backend integration: references/backend-integration.md
- Troubleshooting: references/troubleshooting.md
- Performance: references/performance.md
- Rolldown: references/rolldown.md
- Migration: references/migration.md
- Breaking changes: references/breaking-changes.md
- Environment API: references/api-environment.md
- Environment instances: references/api-environment-instances.md
- Env plugins: references/api-environment-plugins.md
- Env frameworks: references/api-environment-frameworks.md
- Env runtimes: references/api-environment-runtimes.md

## Core rules

- Prefer minimal configuration; extend only as needed.
- Keep `index.html` as a first-class entry point when using Vite defaults.
- Treat dev server settings and build settings separately.
- Document mode-dependent behavior for env variables and `define`.
- Use `future` config to opt-in to deprecation warnings before migration.

## Recipes

- Scaffold a project with `npm create vite@latest`.
- Configure aliases, server options, and build outputs in `vite.config.*`.
- Load `.env` values into config with `loadEnv` when config needs them.
- Add plugins with `plugins: []` and define `apply` or `enforce` when needed.
- Use HMR APIs for fine-grained updates when plugin or framework needs it.
- Use `optimizeDeps.include/exclude` when deps aren't discovered on startup.
- Use `build.rollupOptions.input` for multi-page apps.
- Use the top-level `input` option to declare the entry once for apps without `index.html`; it feeds `build.rolldownOptions.input`, `build.lib.entry`, `build.ssr`, and `optimizeDeps.entries` by default.
- Enable deprecation warnings: `future: { removeSsrLoadModule: 'warn' }`.
- Use `hotUpdate` hook instead of `handleHotUpdate` for environment-aware HMR.
- Use `this.environment` instead of `options.ssr` in plugin hooks.

## Release Highlights (8.0.0)

- Default browser target is raised again under `baseline-widely-available`.
- CommonJS default-import interop becomes more consistent and may expose packages that relied on older ambiguous behavior.
- Vite stops resolving `browser` vs `module` via format sniffing and follows configured `resolve.mainFields` more strictly.
- JS API `build()` now throws `BundleError` with nested `.errors` when multiple Rolldown-level errors are present.
- Rolldown transition becomes more explicit: `build.rollupOptions` / `worker.rollupOptions` are deprecated in favor of `*.rolldownOptions`.

## Release Highlights (8.1.0 -> 8.1.5)

- **WASM ESM integration**: direct `.wasm` imports work as ES modules natively.
- **Zero-config build caching**: integration with Vite Task enables build caching without manual setup.
- **`server.hmr` renamed to `server.ws`**: WebSocket options move under `server.ws`; update configs that set HMR transport options.
- **New options**: `html.additionalAssetSources` for custom asset sources during HTML transform, `import.meta.glob` `caseSensitive`, multiple hosts via `__VITE_ADDITIONAL_SERVER_ALLOWED_HOSTS`, and an extended default `server.fs.deny` list.
- **8.1.1 -> 8.1.5**: stability only (stack-trace handling, dependency bumps, module-resolution edge cases).

## Release Highlights (8.2.0)

- **New top-level `input` option**: `input: string | string[] | { [entryAlias: string]: string }` resolves relative to the project root and becomes the default value for `build.rolldownOptions.input`, `build.lib.entry`, `build.ssr` (when set to `true`), and `optimizeDeps.entries` whenever those are left unset; useful for apps that skip `index.html` and would otherwise repeat the same entry path in several options. The resolved `input` paths are also added to `server.fs.allow`, matching how imported modules are already allowed.
- **Bundled dev mode (`experimental.bundledDev`)**: a boundary-less edit now triggers exactly one reload; the client tells the server to rebuild first and only then issues `full-reload`, so the "bundling in progress" fallback page no longer flashes between an edit and the reload. Worker files (`new Worker(new URL(...))`, `?worker` imports) are now correctly re-emitted through HMR instead of going stale after an edit.
- **Native loader / native-config compatibility**: warnings about features unsupported by `configLoader: 'native'` now include a column alongside the line number, and virtual modules are excluded from the native-config compatibility check so plugin-generated virtual files no longer trigger false positives.
- **Type-safe PostCSS config**: Vite exports `PostcssUserConfig` (re-exported from `postcss-load-config`'s `Config` type) so `postcss.config.js`/`.ts` can be typed directly.
- **Network URL labeling**: dev server network URLs now resolve and print the OS network-interface name (e.g. `eth0`, `wlan0`) even when `server.host` is an explicit address, not only when Vite auto-detects every interface.
- **Rolldown and optimizer updates**: Rolldown bumps to `~1.2.0`, bringing client-side HMR handling into `experimental.bundledDev`; the dependency optimizer's lockfile-hash cache now also recognizes `aube-lock.yaml` (Aube) and `nub.lock` (nub), so those package managers correctly invalidate `node_modules/.vite` on dependency changes.

## Patch Notes (8.3.0 -> 8.3.5)

- The whole `8.3.x` line is fixes only — no new configuration options or APIs.
- **Bundled dev mode:** serves `/@vite/client` and stubs `@vite/env`, imports CSS HMR helpers from `/@vite/client`, applies `server.origin` to asset URLs, exposes user `import.meta.env.*` defines inside the `import.meta.env` object, maps forwarded error stacks through the bundle source maps, and stops HMR propagation at modules that are no longer imported.
- **Build:** chunk import maps handle missing imports and include preload dependencies in the hashing, preloads are corrected for a non-root `base` when `chunkImportMap` is enabled, the preload helper waits for in-flight stylesheets instead of scanning links quadratically, and a missing chunk import map no longer fails the build.
- **Optimizer:** falls back to `yarn.lock` for the lockfile hash, scans `oxc.jsxInject` imports, scans deep imports with custom extensions, and no longer skips imports whose binding starts with `type`.
- **CSS:** a literal `%` inside `url()` no longer fails the build, and preprocessors resolve from their own file path under lightningcss.
- **Server:** `transformIndexHtml` no longer receives the query string in the filename, static aliases match on path boundaries, and file-watcher errors no longer crash the dev server.

## Patch Notes (8.0.14 -> 8.0.16)

- Rolldown moves to `1.0.3` (was `1.0.2` in `8.0.14`); if you maintain plugin or build guidance, validate it against the current Rolldown behavior instead of assuming early `8.0.x` patch semantics.
- Dev server now sends HTTP `408` on request timeout instead of hanging the connection (`8.0.15`).
- `launch-editor-middleware` rejects UNC paths and Windows alternate paths, closing a local path-traversal vector (`8.0.16`); relevant if you expose the dev server beyond localhost.
- `8.0.15` fixes: `/@fs/` HTML-proxy cache-key mismatch, relative-glob-in-virtual-module errors when no files match, closing the Rolldown bundle when `write()` rejects, and `onWarn` for `viteResolvePlugin` in JS plugin containers.
- `transformIndexHtml` handles trailing-slash paths more reliably, which matters for plugins and static deploy setups that rewrite or inject HTML on directory-style URLs.
- Dependency scanning now passes Oxc JSX options through the optimizer path, so JSX-heavy linked dependencies should behave closer to the main transform pipeline.

## Prohibitions

- Do not copy large verbatim chunks from vendor docs.
- Do not assume framework-specific behavior without verifying.

## Links

- [Documentation](https://vite.dev/)
- [Releases](https://github.com/vitejs/vite/releases)
- [GitHub](https://github.com/vitejs/vite)
- [npm](https://www.npmjs.com/package/vite)

© itechmeat · MIT · itechmeat/llm-code

Similar skills

All skills for Frontend and UI →

vite by other authors comes first.

vite Anthony Fu A skill for Claude Code and Codex covers Vite configuration, plugins, SSR, and library builds. It guides work on vite.config.ts and Vite 8 migration. CX Codex +1 42,400installs vite Mindrally Supplies your coding agent with vetted Vite recipes for HMR, chunk splitting, framework plugins, and Vitest setups. CX Codex +1 875installs vite pproenca A performance optimization guide with 42 Vite rules. Helps your AI agent audit configs, optimize bundles, and fix slow dev servers. CX Codex +1 376installs vite oakoss A skill for Vite work: config file, plugins, dev server, build output, SSR and env variables. Useful when the agent edits vite.config.ts in your project. CX Codex +1 138installs vite-patterns affaan-m The vite-patterns skill guides Vite configuration, plugins, HMR, environment variables, and builds. Use it when working with vite.config.ts or a Vite project. CX Codex +1 6,500installs vite-advanced OrchestKit vite-advanced is a Claude Code and Codex skill for Vite 8 builds with Rolldown, chunk splitting, and Environment API. It activates when editing vite.config.* or files under **/vite/**. CX Codex +1 265installs vite-expert carlrannaberg vite-expert optimizes Vite builds, dev server latency, HMR, and SSR configurations. Helps when bundling stalls or dependencies fail under modern ESM rules. CX Codex ★ 763repo stars vite-react-best-practices ant-gravity vite-react-best-practices guides coding agents through deployment, routing, and caching rules for React 19 and Vite 8 SPAs. Triggers during project setup, CI/CD builds, or component refactoring. CX Codex +1 670installs crxjs samber A skill for building Chrome extensions with CRXJS: it walks the agent through real HMR for popup, content scripts and side panels. Useful when your extension already builds on Vite. CX Codex +1 5,100installs react-vite-best-practices agent-skills react-vite-best-practices — a skill with 23 rules for optimizing React apps built with Vite: build config, code splitting, HMR, assets, env variables and bundle analysis. Useful when an agent writes or reviews components. CX Codex +1 3,000installs

From the same set16

The whole set →

Project sponsors

Companies that keep this analytics open