/vite-v8

Vite 8 Skill

Configure, migrate, and debug Vite 8 projects with Rolldown, Oxc, and environment-aware plugin patterns.

What This Skill Does

Provides expert assistance for Vite 8 projects, from vite.config.ts setup through plugin authoring, environment-aware runtime configuration, and Rolldown/Oxc migration. It focuses on the real Vite 8 architecture shift rather than generic bundler advice.

Core Capabilities

• Configure vite.config.ts with Vite 8-era options and conventions
• Migrate legacy Rollup/esbuild-flavored configs to Rolldown/Oxc surfaces
• Author Vite plugins with named environments, hook filters, and environment-aware HMR flows
• Debug SSR/build/runtime issues using Vite 8 mental models such as Module Runner and isolated environments
• Improve production build behavior while keeping dev/build assumptions aligned
• Tune startup and dev-server behavior with warmup, config-loader, and dependency-graph heuristics

Auto-Trigger Keywords

Primary Keywords

• vite
• vite 8
• vite.config.ts
• rolldownOptions
• oxc
• environments
• module runner
• hotUpdate

Secondary Keywords

• lightning css
• ssr.noExternal
• configEnvironment
• this.environment
• hook filters
• rolldown migration
• build target

Error-Based Keywords

• "rollupOptions is not behaving as expected"
• "esbuild config is deprecated"
• "handleHotUpdate"
• "ssrLoadModule"
• "default import from cjs behaves differently"

Known Issues Prevention

When to Use

Use This Skill For

• Creating or fixing vite.config.ts
• Migrating Vite projects to Vite 8 terminology and config surfaces
• Writing or reviewing Vite plugins
• Troubleshooting SSR/runtime/environment-specific behavior
• Improving build config without falling back to outdated Rollup guidance

Don't Use This Skill For

• Framework-only issues that are actually owned by Next.js/Nuxt/etc internals
• Vitest-specific testing workflows where vitest-v4 is the better fit

Version Policy

[!NOTE] This skill targets Vite 8+. It assumes the Rolldown/Oxc-era config surface and modern environment APIs. If the repo is intentionally pinned to an older Vite line, verify version-specific support before applying the migration guidance here.

Quick Usage

# Start dev server
npx vite dev

# Production build
npx vite build

# SSR build
npx vite build --ssr src/entry-server.ts

# Preview production output
npx vite preview

Token Efficiency

Reference Documentation

For deeper guidance on the most failure-prone areas, see:

See the References Index for navigation.

File Structure

vite-v8/
├── SKILL.md        # Quick-start patterns, critical rules, and practical guidance
├── README.md       # This file - discovery and quick reference
└── references/
    ├── README.md                          # Reference index
    ├── core-config-reference.md          # Config and CLI patterns
    ├── plugin-environment-reference.md   # Environment-aware plugin authoring
    ├── build-ssr-migration-reference.md  # Build, SSR, and migration guidance
    └── performance-devserver-reference.md # Startup, dev-server, and scaling guidance

Dependencies

Official Documentation

• Vite Docs
• LLM Index
• Config Reference
• Plugin API
• Build Guide
• SSR Guide
• Environment API

Related Skills

• vitest-v4 - Vitest workflows when the problem is test-runner specific rather than Vite build/runtime specific
• github-actions - CI workflow authoring when Vite builds and previews run in GitHub Actions

License: MIT