Compatibility FAQ

Frequently asked questions about compatibility and system requirements.

Browser Compatibility

Q: Which browsers are supported?

A: VitePress supports all modern browsers:

• Chrome 87+
• Firefox 78+
• Safari 14+
• Edge 88+

Q: Does VitePress work on mobile devices?

A: Yes, VitePress sites are fully responsive and work on all mobile devices and tablets.

Node.js Compatibility

Q: What Node.js versions are supported?

A: VitePress requires Node.js 16.0 or higher. We recommend using the latest LTS version.

Q: Can I use VitePress with older Node.js versions?

A: No, VitePress requires modern Node.js features and will not work with versions below 16.0.

Framework Integration

Q: Can I use VitePress with existing Vue projects?

A: VitePress is designed for documentation sites. For existing Vue projects, consider using Vite directly.

Q: Is VitePress compatible with Vue 2?

A: No, VitePress is built on Vue 3 and is not compatible with Vue 2.

Operating System Support

Q: Which operating systems are supported?

A: VitePress works on:

• Windows 10+
• macOS 10.15+
• Linux (most distributions)

Q: Can I run VitePress on Windows Subsystem for Linux (WSL)?

A: Yes, VitePress works perfectly on WSL and WSL2.

Package Manager Compatibility

Q: Which package managers can I use?

A: VitePress supports:

• npm
• yarn
• pnpm
• bun

Q: Are there any known issues with specific package managers?

A: Generally no, but we recommend using the latest versions of your chosen package manager.