---
title: "Migrate from @linguanahq/compiler"
description: "Move an existing React or TanStack Start integration to the multi-framework Vite package."
canonical_url: "https://docs.linguana.dev/docs/advanced/migrate-compiler"
markdown_url: "https://docs.linguana.dev/docs/advanced/migrate-compiler.md"
x_farming_labs_generated_preamble: true
---

# Migrate from @linguanahq/compiler
URL: /docs/advanced/migrate-compiler
LLM index: /llms.txt
Description: Move an existing React or TanStack Start integration to the multi-framework Vite package.

# Migrate from `@linguanahq/compiler`

Replace the build dependency:

```sh
bun remove @linguanahq/compiler
bun add -d @linguanahq/vite
```

Then select the React adapter explicitly:

```ts
import { linguana } from "@linguanahq/vite";
import { react as linguanaReact } from "@linguanahq/vite/react";

linguana({
  adapter: linguanaReact(),
  projectId: "your-project",
  token: process.env.LINGUANA_PROJECT_TOKEN,
});
```

`environment` now defaults to `development`, `sourceLocale` defaults to `en`, and a supplied token enables manifest upload unless `upload: false` is set. For build-driven translation, replace `targetLocales` with `enabled: true`; the dashboard’s enabled Languages list is authoritative.

The compatibility package remains available for one release and emits one deprecation warning per build.

## Sitemap

See the full [sitemap](/sitemap.md) for all pages.
Docs-scoped sitemap: [/docs/sitemap.md](/docs/sitemap.md).
Well-known sitemap: [/.well-known/sitemap.md](/.well-known/sitemap.md).