---
title: "Next.js support"
description: "Translate Next.js 16 App Router Server and Client Components with @linguanahq/next."
canonical_url: "https://docs.linguana.dev/docs/whats-new/nextjs"
markdown_url: "https://docs.linguana.dev/docs/whats-new/nextjs.md"
x_farming_labs_generated_preamble: true
---

# Next.js support
URL: /docs/whats-new/nextjs
LLM index: /llms.txt
Description: Translate Next.js 16 App Router Server and Client Components with @linguanahq/next.

# Next.js support

The new `@linguanahq/next` package brings automatic extraction and request-aware translation to Next.js 16 App Router apps. Write ordinary JSX in Server and Client Components; no translation keys or Babel configuration are needed.

```bash title="terminal"
npm install @linguanahq/next
```

## Added

- **`withLinguana` for `next.config`.** One wrapper adds extraction to Turbopack and webpack, and composes with existing configuration objects or async configuration functions.
- **Server and Client Components.** `LinguanaProvider` resolves the language once per request and hydrates Client Components with the same catalogs. Supported attributes such as `title`, `placeholder`, `alt`, and `aria-label` are translated too.
- **Explicit messages everywhere.** `T` works in both environments, `getTranslations()` covers server code such as `generateMetadata`, and `useTranslation()` covers Client Components.
- **Language switching without URL changes.** `LanguageSelector` and `setLocale()` validate the target catalog, store the language cookie, and refresh server content while preserving client state.
- **Build manifests and opt-in upload.** `next build` writes `.linguana/manifest.json`. Upload and development-only build translation are explicit options with spending limits.
- **Verified catalogs.** Embedded and hosted catalogs are checked for scope and integrity; any failure renders source text.

## Scope

This release supports the App Router on Next.js 16 with React 19, Turbopack or webpack, and the Node.js runtime. Pages Router, localized URL routing, static export, `cacheComponents`, Edge runtime certification, and local translation preview are not included. The CLI does not scaffold or detect Next.js apps yet.

<NextStep>
Follow the [Next.js guide](/docs/getting-started/nextjs), then see the [Next.js API](/docs/reference/next).
</NextStep>

## 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).