> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.
# Vite
This guide explains how to migrate a Vite project to Rsbuild.
## Installing dependencies
First, replace Vite's npm dependencies with Rsbuild's equivalents.
- Remove Vite dependencies:
```sh [npm]
npm remove vite
```
```sh [yarn]
yarn remove vite
```
```sh [pnpm]
pnpm remove vite
```
```sh [bun]
bun remove vite
```
```sh [deno]
deno remove npm:vite
```
- Install Rsbuild dependencies:
```sh [npm]
npm add @rsbuild/core -D
```
```sh [yarn]
yarn add @rsbuild/core -D
```
```sh [pnpm]
pnpm add @rsbuild/core -D
```
```sh [bun]
bun add @rsbuild/core -D
```
```sh [deno]
deno add npm:@rsbuild/core -D
```
## Test tooling
Vitest uses Vite to transform and run tests, so retain Vite and any Vite plugins referenced by `vitest.config.*` while you use Vitest. To remove Vite from the test toolchain, you can migrate to [Rstest](https://rstest.rs/), which reuses your Rsbuild configuration through `@rstest/adapter-rsbuild`. See the [Testing](/guide/advanced/testing.md) guide and the [Rstest migration guide](https://rstest.rs/guide/migration/vitest) for the required configuration and test API changes.
Remove Vite only after confirming that no other development tool or dependency still requires it.
## TanStack Start
TanStack Start manages client and server entries, deployment output, and framework-specific plugins. Follow the dedicated [TanStack Start migration guide](/guide/migration/tanstack-start.md) instead of the generic build entry steps below.
## Updating npm scripts
Next, update the npm scripts in your package.json to run Rsbuild CLI commands.
```json title="package.json"
{
"scripts": {
"dev": "vite", // [!code --]
"build": "vite build", // [!code --]
"preview": "vite preview", // [!code --]
"dev": "rsbuild", // [!code ++]
"build": "rsbuild build", // [!code ++]
"preview": "rsbuild preview" // [!code ++]
}
}
```
## Create configuration file
Create an Rsbuild configuration file named `rsbuild.config.ts` alongside package.json, and add the following content:
```ts title="rsbuild.config.ts"
import { defineConfig } from '@rsbuild/core';
export default defineConfig({
plugins: [],
});
```
## Build entry
The default build entry points for Rsbuild and Vite are different. Vite uses `index.html` as the default entry, while Rsbuild auto-detects a `src/index.*` module such as `src/index.ts` or `src/index.js`.
When migrating from Vite to Rsbuild, use Rsbuild's [source.entry](/config/source/entry.md) to set the build entry and [html.template](/config/html/template.md) to set the template.
Using a newly created Vite project as an example, first delete the `
```
Then add the following configuration:
```ts title="rsbuild.config.ts"
export default {
html: {
template: './index.html',
},
source: {
entry: {
index: './src/main.ts',
},
},
};
```
Rsbuild automatically injects the `