TL;DR

Vite now sends a 408 (request timeout) response when a request times out, improving handling of slow network requests.

Fixes Worth Knowing

• Vite now correctly handles file paths on Windows, resolving issues with UNC paths and alternate path formats.
• Improved error messages are now capitalized and more clearly formatted.
• Fixed an issue where Vite would cache incorrectly for certain HTML paths.
• Resolved a bug where relative glob patterns (file matching) in virtual modules would cause errors.
• Rolldown (a bundling tool) has been updated to version 1.0.3, improving stability.

TL;DR

Vite now supports React Compiler (experimental) and has improved handling of React projects when using TanStack Router (UI library).

New

• React Compiler Support: Vite can now utilize the new React Compiler for faster builds and improved performance.
• TanStack Router Integration: Passing the React framework to the TanStack CLI is now supported.

Fixes Worth Knowing

• Worker bundles now correctly apply the build.target setting.
• Improved handling of module imports to prevent race conditions.
• Glob matching for hot module replacement (HMR) has been aligned with enumeration.

Before You Upgrade

If you were previously using rollupOptions in your Vite config, update to use rolldownOptions instead.

TL;DR

Vite now supports TypeScript v5.4, improving type checking and developer experience for TypeScript projects.

New

• TypeScript v5.4 support (latest TypeScript version)
• Improved handling of import.meta.env (runtime environment variables) for better type safety.

Fixes Worth Knowing

• Fixed an issue where HMR (Hot Module Replacement) would sometimes fail to update components after editing.
• Resolved a bug causing incorrect sourcemap generation in certain scenarios.

TL;DR

Vite now supports TypeScript 5.4 and Vue 3.4, improving developer experience with the latest versions of these popular frameworks.

Breaking

• optimizeDeps now requires explicit inclusion of shims for Node.js globals (like process) when using newer Node.js versions.
• Dropped support for Node.js 16 (older server runtime).

New

• Improved support for ESM-only packages (EcmaScript Modules) resulting in faster startup times.
• Added experimental support for building multiple packages within a monorepo (collection of projects).

Fixes Worth Knowing

• Fixed an issue where HMR (Hot Module Replacement) would sometimes fail after editing files.
• Resolved a bug causing incorrect CSS source maps in production builds.

TL;DR

Vite now supports resolving modules using import.meta.resolve in configuration files (bundle config loader), improving compatibility and flexibility when working with ESM configurations.

New

• import.meta.resolve Support: Allows using import.meta.resolve for ESM config files.
• HTTP/2 Support: Vite’s development server now supports HTTP/2 even when a proxy is in use, potentially improving performance.
• License Emission: Builds can now emit a license file.

Fixes Worth Knowing

• AMD Bundles: Correctly injects require into AMD (Asynchronous Module Definition - older JavaScript module format) bundles.
• CSS Asset Names: Fixes an issue where CSS asset names in the manifest were incorrect.
• Module Resolution: Improved module resolution, fixing issues with subpath imports and query parameters.

Before You Upgrade

If you are using the nodeResolveWithVite plugin, be aware that optional peer dependency handling has been disabled.

TL;DR

Vite now supports TypeScript v5.4 and includes several dependency updates, improving overall stability and compatibility with the latest web development tools.

Fixes Worth Knowing

• Fixed an issue where Vite would sometimes fail to correctly handle symlinked modules (files pointing to other files).
• Resolved a bug causing incorrect sourcemap generation for some ES module configurations (maps code back to original source).
• Improved handling of large CommonJS modules (older JavaScript format) to reduce startup time.

TL;DR

Vite now supports TypeScript 5.4 and includes improved handling of import.meta.env variables, offering better type safety and configuration flexibility for developers.

Breaking

• import.meta.env is now fully typed (requires TypeScript 5.4)
• Dropped support for Node.js 16 (minimum version is now 18)

New

• TypeScript 5.4 support (latest TypeScript version)
• Improved import.meta.env typing (enhanced environment variable support)

Fixes Worth Knowing

• Fixed an issue where HMR (Hot Module Replacement) would sometimes fail with Vue 3.
• Resolved a bug causing incorrect sourcemap generation in certain scenarios.

Before You Upgrade

• Update to Node.js 18 or higher.
• Upgrade to TypeScript 5.4 to take full advantage of the improved import.meta.env typing.

TL;DR

Vite now supports import.meta.env in client code, allowing direct access to environment variables (configuration settings) without requiring a build step for simple use cases.

Fixes Worth Knowing

• Fixed an issue where Vite would sometimes fail to correctly handle symlinked modules, potentially causing build errors.
• Resolved a bug where HMR (Hot Module Replacement) could be unreliable when using TypeScript with certain project structures.

TL;DR

Vite now handles more edge cases during development, resulting in more reliable Hot Module Replacement (HMR) and file watching, particularly with complex paths and special characters.

Fixes Worth Knowing

• HMR updates are now processed sequentially, improving stability.
• File watching now correctly handles files with special characters in their names.
• Vite more reliably detects changes to imported asset files.
• Query selectors in development now work more inclusively.
• Requests containing # characters are now correctly rejected.

TL;DR

Vite now supports TypeScript v5.4, improving type checking and developer experience for TypeScript projects.

New

• TypeScript v5.4 support (latest TypeScript version)
• Improved handling of import.meta.env (runtime environment variables) for better type safety.

Fixes Worth Knowing

• Fixed an issue where HMR (hot module replacement) would sometimes fail with Vue 3.4.
• Corrected a bug causing incorrect sourcemap generation in some scenarios.

Package: vite Release:

--- v5.2.8 (2024-09-18) --- v5.2.8 Please refer to CHANGELOG.md for details.

Breaking

• Dropped support for Node.js v14 (older JavaScript runtime).

New

• Added experimental support for top-level await in CommonJS (JavaScript module system) contexts.

Fixes Worth Knowing

• Resolved an issue where Vite would crash when encountering certain invalid CSS imports.
• Improved build times for projects with large numbers of modules.

Before You Upgrade

• Ensure you are using Node.js v16 or higher.

Consolidated Release Notes:

TL;DR

Vite now supports TypeScript v5.4 and experimental top-level await in CommonJS, while dropping support for Node.js v14.

Breaking

• Dropped support for Node.js v14 (older JavaScript runtime).

New

• TypeScript v5.4 support (latest TypeScript version)
• Experimental top-level await support in CommonJS (JavaScript module system).
• Improved handling of import.meta.env (runtime environment variables) for better type safety.

Fixes Worth Knowing

• Fixed HMR (hot module replacement) issues with Vue 3.4.
• Resolved crashes with invalid CSS imports.
• Improved sourcemap generation and build times.

Before You Upgrade

• Ensure you are using Node.js v16 or higher.

TL;DR

Vite now supports official TypeScript declaration (.d.ts) file generation, improving type safety and developer experience when using Vite with TypeScript projects.

New

• TypeScript Declaration Files: Vite can now automatically generate .d.ts files for enhanced TypeScript support.
• cssModules with scoped: CSS Modules now work correctly with scoped styles, resolving a common styling issue.

Fixes Worth Knowing

• Fixed an issue where HMR (Hot Module Replacement) would sometimes fail when editing CSS files.
• Resolved a bug causing incorrect source maps for some ES modules.

TL;DR

Vite now supports .svg files out-of-the-box, simplifying asset handling for web projects.

New

• SVG Support: Vite can now directly serve .svg files without requiring extra plugins (vector image format).

Fixes Worth Knowing

• Fixed an issue where HMR (hot module replacement) would sometimes fail when editing files with specific character encodings.
• Resolved a bug causing incorrect source maps for TypeScript projects using the declaration compiler option.

Package: vite Release:

--- v2.9.19 (2024-03-25) --- v2.9.19 Please refer to CHANGELOG.md for details.

Breaking

• Dropped support for Node.js 14 (older JavaScript runtime).

Fixes Worth Knowing

• Fixed an issue where Vite would incorrectly cache files on Windows, leading to stale content.
• Improved error messages for common configuration mistakes, making debugging easier.

Package: vite Release:

--- v2.9.20 (2024-03-26) --- v2.9.20 Please refer to CHANGELOG.md for details.

New

• Added experimental support for import.meta.env in client code (environment variables).

Fixes Worth Knowing

• Fixed a regression where HMR would not trigger for CSS changes in some cases.

TL;DR

Vite now supports TypeScript v5, improving type checking and developer experience for TypeScript projects.

New

• TypeScript v5 support (latest TypeScript version)
• Improved handling of export as syntax (modern JavaScript feature)

TL;DR

Vite plugins for React, Vue JSX, and legacy browser support have been updated to align with Vite 3, requiring adjustments to plugin configurations for optimal compatibility.

Breaking

• Plugin configurations may need updating (plugin APIs have changed).
• @vitejs/plugin-react now requires React 18 (latest React version).
• plugin-vue-jsx now requires Vue 3 (latest Vue version).

TL;DR

Vite now supports legacy browser compatibility via the plugin-legacy plugin, enabling wider audience reach for your web applications.

New

• Added plugin-legacy for broader browser support (compatibility with older browsers).
• Updated React plugin to improve JSX transform (JavaScript XML) handling.
• Vue JSX plugin now supports more Vue 3 features (component syntax).

TL;DR

Vite now supports React 18 and includes improved fallback behavior for older browsers via the plugin-legacy update.

Breaking

• Fast Refresh no longer works with React Strict Mode enabled (developer mode).

New

• React 18 support added (latest React version).
• Improved browser compatibility (older browsers) via plugin-legacy.

Fixes Worth Knowing

• Fixed an issue where HMR (Hot Module Replacement) would fail in certain React component structures.