No more JSON archaeology, string-key roulette, and runtime localization surprises.

Linguini is in a very early stage of development. APIs, generated output, and package boundaries can change quickly while the core model is still being hardened. Check repository state

Why Linguini · Language Reference · Getting Started · Web/SvelteKit

---

Example

The schema is the public contract your app can call:

// linguini/schema/checkout.lgs

enum Item { pasta, sauce }

/// Shown on the delivery confirmation card.
you_ordered(
  customer: String,
  item: Item,
  amount: Number,
  total: Number,
  delivery: Date,
)

cart_summary(amount: Number, item: Item, total: Number)

The locale implements that contract with real language logic:

// linguini/locale/checkout/ru.lgl

enum Gender { masculine, feminine, neuter, other }

impl Item {
  pasta {
    Gender = feminine

    form acc(Plural) {
      one => пасту
      few => пасты
      _   => паст
    }
  }

  sauce {
    Gender = masculine

    form acc(Plural) {
      one => соус
      few => соуса
      _   => соусов
    }
  }
}

form Rubles(Plural) {
  one => рубль
  few => рубля
  _   => рублей
}

form Pronoun(Plural, Gender) {
  one {
    masculine => Его
    feminine  => Её
    _         => Их
  }
  _ => Их
}

you_ordered = {customer}, вы заказали: {amount} {item.acc(amount)} на сумму {total} {Rubles(total)}. {Pronoun(amount, item.Gender)} доставка будет {delivery}.

cart_summary = В корзине {amount} {item.acc(amount)} на сумму {total} {Rubles(total)}

The app gets a generated native API:

import { configureLinguini } from "./generated/linguini";

const l = configureLinguini({ language: () => getRequestLocale() });

l.checkout.you_ordered("Artemy", "pasta", 3, 1290, "2026-05-17");
// → "Artemy, вы заказали: 3 пасты на сумму 1290 рублей. Их доставка будет 17.05.2026."

l.checkout.cart_summary(3, "pasta", 1290);
// → "В корзине 3 пасты на сумму 1290 рублей"

Typed arguments. Plural forms, grammatical gender, and case agreement. Analyzer diagnostics for schema/locale mismatches, invalid references, incomplete branches, and type errors. Generated modules that can be used from app code.

---

Features

Area	Status
Language	.lgs schemas and .lgl locale implementations
Grammar	CLDR plural categories, forms, enum metadata, nested selectors, local helpers
Analyzer	missing implementations, invalid references, incomplete branches, diagnostics
Formatter	.lgs / .lgl formatting and --check mode
LSP	diagnostics, completion, hover, definition, references, symbols, semantic tokens, formatting, rename, code actions
Codegen	TypeScript and generated Svelte 5/SvelteKit adapters today; other targets are not part of the current release
Editor	VS Code extension

---

Project layout

linguini.toml
linguini/
  schema/
    checkout.lgs
  locale/
    checkout/
      en.lgl
      ru.lgl

[project]
name           = "shop"
default_locale = "en"
locales        = ["en", "ru"]

[paths]
schema = "linguini/schema"
locale = "linguini/locale"

[targets.ts]
out         = "src/generated/linguini"
module      = "esm"
declaration = true

A schema file becomes a namespace. checkout.lgs → namespace checkout. locale/checkout/ru.lgl → Russian implementation for that namespace.

---

CLI

Linguini CLI must be installed. The VS Code extension and generated tooling use the linguini command by default and do not include a bundled binary.

cargo install linguini-cli --version 0.1.0-alpha.4

Preview builds use vendored CLDR JSON data from the repository. If that data is missing from a source archive, building the CLDR support crate may need network access to fetch the pinned CLDR source.

linguini init      Create a project skeleton
linguini check     Report diagnostics across schema and locale files
linguini fix       Apply quick fixes — missing files, message stubs
linguini build     Build and write codegen outputs
linguini generate  Render sample output for all locales and enum variants
linguini format    Format .lgs and .lgl files
linguini lsp       Start the language server over stdio

---

Development

cargo test --workspace

VS Code extension:

cd editors/vscode
npm install
npm run compile
npm run open:dev

---

License

Apache 2.0 — see LICENSE.

Built by Antepod.