---
title: "Get started"
description: "Choose a code or AI agent path to your first published language."
canonical_url: "https://docs.linguana.dev/docs/getting-started"
markdown_url: "https://docs.linguana.dev/docs/getting-started.md"
x_farming_labs_generated_preamble: true
---

# Get started
URL: /docs/getting-started
LLM index: /llms.txt
Description: Choose a code or AI agent path to your first published language.

# Get started

Use an existing Vite app with React, Vue, Svelte, or Solid. TanStack Start uses the React integration with request-aware server rendering.

<GettingStartedPaths />

## 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. [Quickstart with code](/docs/getting-started/quickstart) or [set up with an AI agent](/docs/getting-started/ai-agent-setup).
2. [Connect hosted translations](/docs/getting-started/connect-your-app) after local extraction works.
3. [Edit and review strings](/docs/use-linguana/edit-strings), then [publish a language](/docs/use-linguana/publish-language).

Use [Install Linguana](/docs/getting-started/install) for package and config details, [framework setup](/docs/getting-started/frameworks) for Vue, Svelte, and Solid, or [TanStack Start](/docs/getting-started/tanstack-start) for SSR. Look up unfamiliar terms in the [glossary](/docs/getting-started/glossary).

<ExpectedResult>
Your first build contains the app's visible text. Once a target catalog is published to the environment your runtime reads, selecting that language shows the translated text. Missing text remains readable in the source language.
</ExpectedResult>

<NextStep>
Start with [the quickstart](/docs/getting-started/quickstart) or [the agent prompt](/docs/getting-started/ai-agent-setup).
</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).