Vite
Anthony FuCommunityCreated by Anthony Fu
- Skill
- Tool integration
- Software development
- MIT
- No issues found
AutoGineer summary
Written by AutoGineer from the skill’s own files, not by the author
This skill provides comprehensive reference material for Vite 8, a frontend build tool that utilizes the Rolldown bundler and Oxc transformer. It covers core configuration patterns, the plugin API, library mode, and SSR primitives. It also includes specific guidance for migrating to Vite 8, managing multi-environment setups, and utilizing the JavaScript API for programmatic control over build and development processes.
What it does
- Provides patterns for vite.config.ts including conditional and asynchronous configurations.
- Explains the Rolldown migration process for Vite 8 projects.
- Details the Vite plugin API for creating custom hooks and virtual modules.
- Offers guidance on library mode, SSR middleware, and multi-page application setups.
- Documents the JavaScript API for programmatic server creation and build execution.
- Lists official plugins for framework support including Vue and React.
When to use it
- When configuring a new or existing Vite 8 project.
- When migrating a project from previous Vite versions to Vite 8.
- When building libraries or SSR applications using Vite primitives.
- When developing custom Vite plugins or integrating multi-environment support.
- When needing to programmatically control the Vite build or dev server via the JavaScript API.
Advantages
- Centralized reference for Vite 8 specific changes like Rolldown and Oxc.
- Clear examples for complex configurations like proxying and environment variables.
- Provides structured guidance for library distribution and multi-page entry points.
- Includes TypeScript intellisense patterns for configuration files.
Usage examples
- “How do I configure a proxy in my vite.config.ts?”
- The skill provides a code snippet showing the server.proxy configuration object with target, changeOrigin, and path rewrite options.
- “Show me how to set up a library build in Vite 8.”
- The skill provides a configuration example using the build.lib option, including entry points and rolldownOptions for external dependencies.
- “How do I access environment variables inside my Vite config?”
- The skill demonstrates using the loadEnv function within a defineConfig function to access variables from .env files during configuration resolution.
- “What is the new way to define entry points in Vite 8?”
- The skill explains the top-level input option which replaces previous entry point configurations for build, SSR, and dependency optimization.
Install
Download the skill as a ZIP:
https://autogineer.com/agent-skills/antfu/vite/downloadUnzip it into the cross-client skills folder of your project:
mkdir -p .agents/skills && unzip vite.zip -d .agents/skills
Documentation by Anthony Fu
Vite
Based on Vite v8.3.5 (Rolldown-powered), generated at 2026-11-05. Vite 8 uses the Rolldown bundler and the Oxc transformer instead of esbuild + Rollup.
Vite is a next-generation frontend build tool with fast dev server (native ESM + HMR) and optimized production builds.
Preferences
Use TypeScript: prefer
vite.config.tsAlways use ESM, avoid CommonJS
Core
| Topic | Description | Reference |
|---|---|---|
| Configuration | vite.config.ts, defineConfig, conditional configs, loadEnv | core-config |
| Features | import.meta.glob, asset queries (?raw, ?url), import.meta.env, HMR API | core-features |
| Plugin API | Vite-specific hooks, virtual modules, plugin ordering | core-plugin-api |
Build & SSR
| Topic | Description | Reference |
|---|---|---|
| Build & SSR | Library mode, SSR middleware mode, ssrLoadModule, JavaScript API | build-and-ssr |
Advanced
| Topic | Description | Reference |
|---|---|---|
| Environment API | Vite 6+ multi-environment support, custom runtimes | environment-api |
| Rolldown Migration | Vite 8 changes: Rolldown bundler, Oxc transformer, config migration | rolldown-migration |
Quick Reference
CLI Commands
vite # Start dev server
vite build # Production build
vite preview # Preview production build
vite build --ssr # SSR buildCommon Config
import { defineConfig } from 'vite'
export default defineConfig({
plugins: [],
resolve: { alias: { '@': '/src' } },
server: { port: 3000, proxy: { '/api': 'http://localhost:8080' } },
build: { target: 'esnext', outDir: 'dist' },
})Official Plugins
@vitejs/plugin-vue- Vue 3 SFC support@vitejs/plugin-vue-jsx- Vue 3 JSX@vitejs/plugin-react- React with Oxc/Babel@vitejs/plugin-react-swc- React with SWC@vitejs/plugin-legacy- Legacy browser support
Files
- ATTRIBUTION.mdAdded by AutoGineer889 B
- GENERATION.md134 B
- LICENSELicence file added by AutoGineer1.1 KiB
- SKILL.md2.5 KiB
- references/build-and-ssr.md3.7 KiB
- references/core-config.md4.0 KiB
- references/core-features.md5.1 KiB
- references/core-plugin-api.md6.0 KiB
- references/environment-api.md4.4 KiB
- references/rolldown-migration.md5.3 KiB
references/core-config.md
name: vite-config description: Vite configuration patterns using vite.config.ts
Vite Configuration
Basic Setup
// vite.config.ts
import { defineConfig } from 'vite'
export default defineConfig({
// config options
})Vite auto-resolves vite.config.ts from project root. Supports ES modules syntax regardless of package.json type.
Conditional Config
Export a function to access command and mode:
export default defineConfig(({ command, mode, isSsrBuild, isPreview }) => {
if (command === 'serve') {
return { /* dev config */ }
} else {
return { /* build config */ }
}
})command:'serve'during dev,'build'for productionmode:'development'or'production'(or custom via--mode)
Async Config
export default defineConfig(async ({ command, mode }) => {
const data = await fetchSomething()
return { /* config */ }
})Using Environment Variables in Config
.env files are loaded after config resolution. Use loadEnv to access them in config:
import { defineConfig, loadEnv } from 'vite'
export default defineConfig(({ mode }) => {
// Load env files from cwd, include all vars (empty prefix)
const env = loadEnv(mode, process.cwd(), '')
return {
define: {
__APP_ENV__: JSON.stringify(env.APP_ENV),
},
server: {
port: env.APP_PORT ? Number(env.APP_PORT) : 5173,
},
}
})Key Config Options
input (top-level, Vite 8)
Declare entry points once at the top level. Acts as the default for build.rolldownOptions.input, build.lib.entry, build.ssr (when true), and optimizeDeps.entries. Useful when the app has no index.html entry.
export default defineConfig({
input: 'src/main.ts',
// or multi-page: { main: 'index.html', nested: 'nested/index.html' }
})resolve.alias
export default defineConfig({
resolve: {
alias: {
'@': '/src',
'~': '/src',
},
},
})The array form's customResolver was removed in Vite 8 — use a custom plugin with a resolveId hook and enforce: 'pre' instead.
define (Global Constants)
export default defineConfig({
define: {
__APP_VERSION__: JSON.stringify('1.0.0'),
__API_URL__: 'window.__backend_api_url',
},
})Values must be JSON-serializable or single identifiers. Non-strings auto-wrapped with JSON.stringify.
plugins
import vue from '@vitejs/plugin-vue'
export default defineConfig({
plugins: [vue()],
})Plugins array is flattened; falsy values ignored.
server.proxy
export default defineConfig({
server: {
proxy: {
'/api': {
target: 'http://localhost:3000',
changeOrigin: true,
rewrite: (path) => path.replace(/^\/api/, ''),
},
},
},
})build.target
Default 'baseline-widely-available' → ['chrome111', 'edge111', 'firefox114', 'safari16.4', 'ios16.4'] (Vite 8, Baseline Widely Available as of 2026-01-01). Customize:
export default defineConfig({
build: {
target: 'esnext', // or 'es2020', ['chrome90', 'firefox88']
},
})To set the dev/transform target, use oxc.target (replaces esbuild.target); build.target takes precedence for builds.
tsconfig (Vite 8)
Force a specific tsconfig instead of Vite's per-file discovery. Discouraged — prefer placing tsconfig.json near the files it configures and using TS references.
export default defineConfig({ tsconfig: './tsconfig.app.json' })devtools (Vite 8, experimental)
Enable Vite DevTools integration (requires @vitejs/devtools* packages). Cannot be set from a plugin config hook.
export default defineConfig({ devtools: { apply: 'serve' } })TypeScript Intellisense
For plain JS config files:
/** @type {import('vite').UserConfig} */
export default {
// ...
}Or use satisfies:
import type { UserConfig } from 'vite'
export default {
// ...
} satisfies UserConfig<!-- Source references: - https://vite.dev/config/ - https://vite.dev/guide/ -->
Requirements and compatibility
Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta
“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.
Security
No issues found by our static scan· No issues found
A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.
Attribution and licence
- Created by
- Anthony Fu
- Publisher
- Anthony Fu (Community)
- Source
- antfu/skills · skills/vite · commit f63e9ec
- Licence
- MIT License (redistribution allowed)
- LICENSE (added by AutoGineer from LICENSE.md)
- ATTRIBUTION.md (written by AutoGineer)
- Synced
AutoGineer is not affiliated with or endorsed by Anthony Fu or Anthony Fu.
Download ZIP
The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download vite.zip