Introducing the Linguana CLI: a translated app in one command

Today we are releasing the Linguana CLI. One command creates a complete app (a blog, a SaaS landing page, or a storefront) in your framework, already translated into four languages. When you want your own translations, the same CLI signs you in, links the app to a Linguana project, and checks the setup.

$ npx @linguanahq/cli create app my-blog

The package is @linguanahq/cli 0.1.0, released under the MIT license. It needs Node.js 22.12 or later, or Bun, and works with npm, pnpm, Yarn, and Bun projects.

Why a CLI for localization#

Most localization tools start after you have built something: you add an i18n library, invent keys, move your copy into JSON files, and wire up a sync. Linguana already removes most of that. Its build-time compiler finds the text in your components, so there are no keys and no locale files to maintain. You can read more about that approach on the product page.

The CLI removes the remaining step: the blank project. Instead of reading a setup guide and hoping your config is right, you start from an app where everything is already connected, and then make it yours.

Create a translated app in one command#

Run create app and answer four prompts: the template, the framework, the package manager, and whether to connect to Linguana or try the demo.

Each answer is also a flag, so you can skip the prompts entirely:

npx @linguanahq/cli create app my-store \
  --template storefront \
  --framework vue \
  --package-manager pnpm \
  --demo

Run npx @linguanahq/cli templates list to see every template and the frameworks it ships in.

Fifteen apps, five frameworks#

There are three templates, and each one is a finished app rather than a skeleton:

• Elsewhere, a blog: six complete articles, search and categories, and localized dates.
• Relay, a SaaS landing page: an interactive product preview, monthly and annual pricing, and accessible demo forms.
• Common Goods, a storefront: eight original products, search, sort, and filters, and a persistent shopping cart.

Every template is available in React, Vue, Svelte, SolidJS, and TanStack Start: fifteen apps in total. You can browse them, with screenshots, in the template gallery.

The templates are frontends. Demo forms send nothing and the storefront's checkout takes no payments. CMS services, customer accounts, and real payments are yours to add.

Four languages, including right-to-left#

In demo mode, each app ships with English, French, Spanish, and Arabic. Switching to Arabic flips the layout to right-to-left, so you can see how your design holds up in both directions before you write any code.

Demo mode needs no account and makes no requests to Linguana. It is the quickest way to see what a multilingual app built with Linguana looks like.

Connect when you are ready#

When you want to translate your own copy, three commands connect the app to a project.

$ npx @linguanahq/cli login$ npx @linguanahq/cli link

The CLI is careful with credentials. Your session is stored outside the project, separately for each API origin. Build tokens go only into an ignored environment file and never get a browser prefix, and the CLI refuses to write to tracked environment files. logout revokes the CLI session without signing your browser out.

Check your setup with doctor#

doctor checks everything the app needs to build with Linguana: the SDK packages, the build configuration, your CLI session, the environment file, and the project token. Each check either passes or tells you what to fix.

$ npx @linguanahq/cli doctor

doctor supports Vite and TanStack Start apps today. whoami, orgs list, and projects list show which account, organizations, and projects the CLI can see.

Built for CI and AI coding agents#

Every prompt has a flag, and the CLI never waits for input when it is not attached to a terminal. Add --yes to accept defaults and --json for machine-readable output:

npx @linguanahq/cli create app my-store \
  --framework vue --template storefront --demo \
  --package-manager pnpm --skip-install --yes --json

That makes the CLI a good fit for AI coding agents like Claude Code, Cursor, Codex, and Copilot. An agent can scaffold a template, run doctor, and read the JSON result without guessing at prompts. The AI agent setup guide has a copy-paste prompt for adding Linguana to an existing app.

What the CLI doesn't do yet#

• There is no Next.js template, and doctor does not check Next.js apps yet. Next.js apps are supported by the SDK through @linguanahq/next.
• The CLI does not deploy your app or sign in to a hosting provider.
• --yes never chooses connected mode on its own, because connecting needs an account.

Get started#

The CLI documentation covers every command and flag, and the CLI page has the full command reference. The changelog lists everything else we have shipped.