🪂 Paraglide JS

Compiler-based i18n library that emits tree-shakable translations, leading to up to 70% smaller i18n bundle sizes.

Documentation · Quick Start · Report Bug

<sub>Used in production by

                ...and more</sub>

_{Trusted by framework authors}

SvelteKit's official i18n integration
Part of TanStack's CI pipeline

Code Preview

// messages/en.json
{
  "greeting": "Hello {name}!"
}

import { m } from "./paraglide/messages.js";

m.greeting({ name: "World" }); // "Hello World!" — fully typesafe

The compiler generates typed message functions. Your bundler tree-shakes unused messages. Expect up to 70% smaller i18n bundle sizes compared to runtime i18n libraries (e.g. 47 KB vs 205 KB).

Why Paraglide?

Works With Your Stack

React · Vue · TanStack Start · SvelteKit · React Router · Astro · Vanilla JS/TS

[!TIP] Paraglide is ideal for any Vite based app. Setup is just one plugin and Vite's tree-shaking eliminates unused messages automatically. Get started →

Quick Start

npx @inlang/paraglide-js init

The CLI sets up everything:

• Creates your message files
• Configures your bundler (Vite, Webpack, etc.)
• Generates typesafe message functions

Then use your messages:

import { m } from "./paraglide/messages.js";
import { setLocale, getLocale } from "./paraglide/runtime.js";

// Use messages (typesafe, with autocomplete)
m.hello_world();
m.greeting({ name: "Ada" });

// Get/set locale
getLocale(); // "en"
setLocale("de"); // switches to German

Full Getting Started Guide →

How It Works

Paraglide compiles an inlang project into tree-shakable message functions. Your bundler eliminates unused messages at build time.

       ┌────────────────┐
       │ Inlang Project │
       └───────┬────────┘
               │
               ▼
  ┌────────────────────────┐
  │  Paraglide Compiler    │
  └───────────┬────────────┘
              │
              ▼
 ┌──────────────────────────┐
 │ ./paraglide/messages.js  │
 │ ./paraglide/runtime.js   │
 └──────────────────────────┘

Watch: How Paraglide JS works in 6 minutes →

Message Format

Paraglide uses Intl.PluralRules for locale-aware pluralization, supporting all CLDR plural categories (zero, one, two, few, many, other) and ordinals (1st, 2nd, 3rd). Gender and custom selects are supported via the variants system.

// Pluralization example
m.items_in_cart({ count: 1 }); // "1 item in cart"
m.items_in_cart({ count: 5 }); // "5 items in cart"

// Works correctly for complex locales (Russian, Arabic, etc.)

Message format is plugin-based — use the default inlang format, or switch to i18next, JSON, or ICU MessageFormat via plugins.

Pluralization & Variants Docs →

Comparison

Full Comparison →

What Developers Say

"Paraglide JS is by far the best option when it comes to internationalization. Nothing better on the market."

Ancient-Background17 · Reddit

"Just tried Paraglide JS. This is how i18n should be done! Totally new level of DX."

Patrik Engborg · @patrikengborg

"I was messing with various i18n frameworks and must say Paraglide was the smoothest experience. SSG and SSR worked out of the box."

Dalibor Hon · Discord

"I migrated from i18next. Paraglide reduced my i18n bundle from 40KB to ~2KB."

Daniel · Why I Replaced i18next with Paraglide JS

Talks

• Paraglide JS 1.0 announcement
• Svelte London January 2024 Meetup

Ecosystem

Paraglide is built on the open inlang format. Works with:

Explore the inlang ecosystem →

Documentation

• Getting Started
• Framework Guides (React Router, SvelteKit, Astro, etc.)
• Message Syntax & Pluralization
• Routing & SSR
• API Reference

Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

• GitHub Issues
• Discord Community

License

MIT — see LICENSE