docs

Get started

Start a new app with the CLI and templates, or add Linguana to an existing app:

Your appIntegrationGuide
New app@linguanahq/cli templatesCLI and templates
React on Vite@linguanahq/react + @linguanahq/viteQuickstart
Vue, Svelte, or Solid on ViteFramework runtime + @linguanahq/viteFramework setup
TanStack Start@linguanahq/react + @linguanahq/vite, with request-aware SSRTanStack Start
Next.js 16 App Router@linguanahq/next with Turbopack or webpackNext.js

Start with the CLI

The fastest way to see Linguana working is a template app. Demo mode needs no account:

terminal
npx @linguanahq/cli create app my-blog --framework react --template blog --demo
cd my-blog
npm run dev

Replace --demo with --connect to sign in through your browser and set up a project, or run link in the app later. The CLI writes the project ID and credentials into an ignored .env.local, so you can skip copying values from the dashboard.

Before you begin

For local extraction, you need access to the app's repository and a working build. No account or token is required. For hosted translation, you need a Linguana organization and project, an enabled target language, and permission to translate and publish.

If you work through an AI coding agent, give it repository access and the setup prompt. Someone still needs to connect the build; after that, daily translation work happens in the dashboard.

Follow your path

  1. Create an app with the CLI, quickstart with code, or set up with an AI agent.
  2. Connect hosted translations after local extraction works.
  3. Edit and review strings, then publish a language.

Use Install Linguana for package and config details, framework setup for Vue, Svelte, and Solid, TanStack Start for SSR, or Next.js for the App Router. Look up unfamiliar terms in the glossary.

Did this page get you to a working result?

On this page

No Headings